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Preface 



The ULTRIX-32 Installation Guide is written for people who are responsible for 
installing ULTRIX-32 software on a VAX system. 

To install the ULTRIX-32 system, you must have system management experience, 
and know how to generate, maintain, and tune a midsized system. If you plan to 
tailor the system, you must understand the VAX processor in general, as well as your 
site's specific implementation. 

In addition to this general knowledge, you must be familiar with the ed ( 1 ) line editor. 
For a quick reference of ed, see The ed Command Summary Sheet, also included in 
this document. 

1. Format of the Installation Guide 

This installation guide is divided into five sections: Introduction, Bootstrap Procedure, 
System Setup, Network Setup, Additional Setup Information. It also contains three 
appendixes. Below is a brief description of each section and the appendixes. 

Introduction 

This section provides basic information concerning the hardware supported, dis- 
tribution medium backups, and block and raw devices. 

Bootstrap Procedure 

This section explains how to install the ULTRIX-32 operating system and bring 
the system up to single-user mode. 

The section is divided into six subsections: 

Bootstrap Procedure for VAX-1 1/730 from Tape Distribution 
Bootstrap Procedure for VAX-1 1 /750 from Tape Distribution 
Bootstrap Procedure for VAX-1 1/780 from Tape Distribution 
Bootstrap Procedure for All VAXes from RA60 Distribution 
Bootstrap Procedure for All VAXes from RK07 Distribution 
Bootstrap Procedure for All VAXes from RL02 Distribution 

You need only read the subsection that pertains to your particular VAX proces- 
sor. For example, if your processor is a VAX- 11/780, skip subsections 2.1 and 
2.2, and read subsection 2.3. 

System Setup 

This section explains how to set up the ULTRIX-32 operating system once the 
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bootstrap procedure has been completed. Topics include generating a new ker- 
nel with selected device drivers, terminal configuration, site tailoring, and bring- 
ing the system up to multi-user mode. 

Network Setup 

This section explains how to configure your ULTRIX-32 operating system for 
networking. Network Setup contains three main subsections: The Configuration 
File, Network Databases, and Routing and Gateways. 

Additional Setup Information 

This section provides additional system setup details you will need once your 
ULTRIX-32 system is up and running. 

The subsections in Additional Setup Information describe how to: fine tune the 
disk configuration, set up the line printer system, set up the mail system, set up 
a UUCP connection, and the installation procedure for the Additional Software 
found on the second distribution tape and the third distribution RK07 pack. 

Appendixes 

Appendix A provides information on the contents of the distribution tape and 
the control status register addresses which the boot software and generic system 
use. Appendix A is for reference only. 

Appendix B provides information on troubleshooting your installation. Should 
you encounter problems while installing the ULTRIX-32 operating system, 
including errors or warning messages, consult this appendix. 

Appendix C provides instructions for a final attempt to install the ULTRIX-32 
software from the tape distribution. Use Appendix C in the rare event that all 
previous attempts to install the system from tape fail. 

2. Additional References 

To install the ULTRIX-32 system, you will need the following manuals. They are also 
included in this binder. 

• Building an ULTRIX-32 System with Config 

• UUCP Installation and Administration 

• Guidelines for System Management 

You will also need the ULTRIX-32 Programmer's Manual. 
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3. Format Conventions 

The ULTRIX-32 Installation Guide observes these conventions: 
Conventions 



bold 



color 



command (n) 

<CTRL/X> 

<CTRL/C> 
<CTRL/U> 
<DELETE> 

italics 

<RETURN> 



Literals are printed in bold type. Literals are frequently used to indicate a 
specific command option and, therefore, should be entered exactly as printed. 

Examples are printed in color. Examples represent command sequences or 
information that you would enter from your terminal. 

The manual section number containing the applicable description (n) is 
enclosed in parentheses after a command or file name. For example, cat(l) 
refers to the description of the cat command in section one of the ULTRIX-32 
Programmer's Manual. 

Terminal control characters are represented by <CTRL/X>, where X is a sin- 
gle character. Generate terminal control characters by holding down the 
CTRL key and entering the character. 

Use <CTRL/C> to interrupt a process. 

Use < CTRL/U > to erase the current line. 

The DELETE key is represented by <DELETE>. Use <DELETE> to erase 
the last character typed. 

Substitutable parameters are printed in italics. 

The RETURN key is printed as <RETURN>. Press the RETURN key after 
entering the command sequence to invoke the commands. 



special type Command and file names are printed in special type. 



Data Entry Conventions 



case The ULTRIX-32 system differentiates between uppercase and lowercase char- 

acters. Therefore, enter uppercase characters only where specifically indicated 
by an example or the command syntax. 
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comments Any comments are enclosed in parentheses to the right of, or below com- 
mands. 

# A number sign represents the superuser prompt. 

»> When in console mode, the console subsystem prompt is represented by three 

right angle brackets, >». 
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The ed Command Summary Sheet 



This command sheet provides an outline of how to use the ed ( 1 ) line editor. It pro- 
vides enough information for you to edit the files necessary to install your ULTRIX- 
32 system. 

Concepts 

To use ed you must understand a few concepts: 

current line The current line of a file is the line at which you are working. When 
you first invoke ed, the current line is the last line in the file. 

A dot (.) represents the current line. If you type a dot on a line by 
itself ed prints the current line. 

$ A dollar sign ($) represents the last line in the file. Thus, the com- 

mand .,$p tells ed to print the current line through the last line of the 
file. 

? A question mark (?) is the ed prompt. A question mark indicates ed 

is ready for your next command, ed also prompts with a question 
mark if you issue a command incorrectly. 

<RETURN> Remember to press the <RETURN> key after each ed command. 

Pressing the <RETURN> key on a line by itself causes ed to make 
the next line the current line. If you are already at the last line of the 
file and press <RETURN>, ed responds with a question mark. 

The following is a table of the most commonly used ed commands, and a brief 
description of each. 

Command Action 



ed xxxx Edits the file xxxx. If the file does not exist, this command creates a 
new file named xxxx and edits it. 

.= Prints the number of the current line. This is useful for orientation. 

[n,m]p Prints the line(s) specified, n is the number of the first line you want 

to print and m is the number of the last line you want to print. If you 
do not specify a line number(s) the current line is printed by default. 
For example: 1 , 1 0p prints the first 10 lines of the file. 

Makes the previous line the current line. 



xiv ULTRIX-32 Installation Guide 



a Appends (adds) text to the file, a adds the text after the current line. 

Terminate the appended text with a dot (.) on a line by itself. 

i Inserts text above the current line. Terminate the inserted text with a 

dot (.) on a line by itself. 

dp Deletes the current line and prints the new current line. 

/xxx/p Searches for the string xxx, and prints the line containing that entry. 

This line becomes the current line. 

s/xxx/yyy/p Substitutes the string yyy for the string xxx in the current line, and 
then prints the line. 

w Writes the file and incorporates all changes. To save the file with all 

the changes, always use the w command. Then use the q command to 
exit the editor. 

q Quits (exits) the file. To prevent mistakes, ed does not allow you to 

use the q command without first writing the file with the w command. 

Q Quits (exits) the file without incorporating changes.. The file remains 

as it was before the editing session. 



Sample ed Session 

The following is a sample ed session with an example / etc /f stab file. In this example, 
a line is deleted, a line is modified, and a line is added. Note that each command is 
followed by <RETURN>. 



# ed /etc/fstab 
67 

<RETURN> 
? 

1,$P 

/dev/hk0a:/:rw:1:1 
/dev/hkOg: /usr:xx: 1 :2 
/dev/hk1a:/usr/sys:rw:1:3 

/ dev / hkOg: / usr:xx: 1 :2 

s / xx / rw / p 

/dev/hkOg:/usr:rw: 1:2 
<RETURN> 

/dev/hk1a:/usr/sys:rw:1:3 
a 

/ usr/ dev/ hk 1 g: / usr/ users:rw: 1 
<RETURN> 



(number of characters in the file) 

(ed is ready for your next command) 
(print the entire file) 



(make the previous line the new current line) 

(substitute rw for xx on the current line) 

(this is the modified line) 

(make the next line the new current line) 

(add text after the current line) 
4 (appended text) 

(terminate the appending mode) 
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? (ed is ready for your next command) 

1 ,$p (print the entire file) 

/dev/hk0a:/:rw:1:1 

/dev/hk0g:/usr:rw:1:2 

/dev/hk1a:/usr/sys:rw:1:3 

/ usr/ dev / hk 1 g: / usr/ users:rw: 1 :4 

i (insert text above the current line) 

/usr/dev/hk1g:/usr/mnt:rw:1 :4 (inserted text) 

(terminate the inserting mode) 
1 ,$p (print the entire file) 

/dev/hkOa:/:rw:1:1 
/dev/hk1a:/usr/sys:rw:1:3 
/usr/dev/hk1g:/usr/mnt:rw:1 :4 
/ usr / dev / hk 1 g: / usr / users:rw: 1 :4 

(make the previous line the current line) 

/usr/dev/hk1g:/usr/mnt:rw:1 :4 

dp (delete the current line and 

print the new current line) 

/usr/dev/hk1g:/usr/users:rw:1:4 

1 ,$p (print the entire file) 

/dev/hkOa:/:rw:1:1 

/dev/hk0g:/usr:rw:1:2 

/dev/hk1a:/usr/sys:rw:1:3 

/usr/dev/hk1g:/usr/users:rw:1:4 

w (write the file (save the modifications)) 

1 00 (number of characters in the file) 

q (quit the ed editor) 

# 



For further information on ed read A Tutorial Introduction to the UNIX Text Editor 
in ULTRIX-32 Supplementary Documents, Volume I. 



ULTRIX-32 Installation Guide 1 



1. Introduction 

This document explains how to install ULTRIX-32 software on your VAX system. 

1.1. Hardware Supported 

The ULTRIX-32 distribution can be installed on a VAX- 11/730, VAX- 11/750, or 
VAX-11/780 CPU with the following disks: 

MASSBUS (except 11/730): RM03, RM05, RM80, RP06, RP07 (except 11/750) 
UNIBUS: RK07, RA60, RA80, RA81 
IDC (11/730, only): R80 

The supported tape drives are: 

MASSBUS (except 1 1/730): TE16, TU77, TU78 
UNIBUS: TS1 1 , TU80 

1.2. Distribution Format 

The basic distribution kit contains these items: 

• Two 1600 bits/in magnetic tapes, nine RL02s, three RK07s, or one RA60 

• One TU58 console cassette, or one RX01 console floppy disk 

The console medium distributed with the system is for installation only. It is not suit- 
able for use as the standard local console medium. 

NOTE: The entire distribution may not fit on some VAX configurations. If you have 
limited disk space, you will need to decide which files are not critical to your installa- 
tion, and omit them. 

1.3. Backup the Distribution Medium 

If you have the facilities, make backup copies of the distribution medium. 
1.3.1. Magnetic Tape Distribution Medium 

The tapes are 9-track 1600 bits/in and contain 512-byte records followed by 10240- 
byte records. The records are interspersed with tape marks; end-of-tape is signaled by 
a double end-of-file. 

The basic bootstrap material is in three files at the beginning of the boot tape. The 
first file on the tape contains preliminary bootstrapping programs and a TP image 
containing several stand-alone programs. The TP image is followed by the second file, 
which is a binary image of a 300 kilobyte mini-root filesystem. The third file is a full 
dump of the root filesystem (see dump (8)). 

The remaining files on the first and second tapes contain tape archive images (see 
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tar(l)). The fourth file on the boot tape contains the kernel objects. The fifth tape 
file contains most of the files in the / usr filesystem. 

The directories on the second tape (labeled Additional Software) are: /usr/ man, 
/usr/games, /usr/doc, /usr/lib/vfont, /usr/ lib /learn, /usr/lib/lisp, and /usr/new. 

1.3.2. RA60 and RK07 Distribution Media 

You should make backup copies of the RA60 and RK07 distribution disks onto scratch 
disks, and then run your system off the newly coped disk(s). The original distribution 
disk(s) should be saved for backup purposes. 

Subsection 2.4.3 explains how to backup the RA60 disks, and subsection 2.5.3 explains 
how to backup the RK07 disks. 

1.3.3. RL02 Distribution Medium 

It is not necessary to make backup copies of the RL02 distribution disks because you 
will be running off of other, larger disks. This leaves the original distribution disks 
free for backup purposes. 

1.4. Devices: Block and Raw 

ULTRIX-32 software makes a distinction between block and raw (character) devices. 

A raw device is designated with an r. For example, an fsck on a raw device called 
hpOa is specified: 

# fsck /dev/rhpOa 

It is important that you do not indiscriminately alter the command syntax given in 
this document with regard to block versus raw device specification. 

1.5. newfs 

Throughout the installation you will be using the newfs (8) command. Always save 
the super-block numbers that newfs generates; they may be valuable in an emergency. 
A good storage place is taped to the outside of the disk cover (if the disk is remov- 
able). 



2. Bootstrap Procedure 
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Section 2 explains how to bootstrap ULTRIX-32 software. 

If you are already running UNIX software, save your existing files before beginning 
the bootstrap. The ULTRIX-32 system and the 4.2 BSD UNIX system use a totally 
different file system organization than previous versions of UNIX systems; therefore, 
you must rebuild the file system format before restoring the data. The easiest way to 
save the current files on tape is to do a full dump and then restore under the new sys- 
tem. 

The subsections in this section describe the bootstrap procedure for installing the 
ULTRIX-32 software on a VAX-11/730, VAX-11/750, and VAX-11/780 processor from 
distribution tapes, and distribution disks (RA60s, RK07s, and RL02s). Go to the sub- 
section pertaining to your particular VAX system and/or distribution media, and fol- 
low the procedures outlined. For example, if your system is a VAX-11/780 and your 
distribution media is magnetic tape, then go directly to subsection 2.3. 

Table 2.1 lists each subsection, the type of media, and the VAX system each subsec- 
tion describes. 

Table 2.1 Bootstrap Procedure Subsections 
Su bsection Media System 



2.1 mag. tape VAX-11/730 

2.2 mag. tape VAX-11/750 

2.3 mag. tape VAX-11/780 

2.4 RA60 all VAX systems 

2.5 RK07 all VAX systems 

2.6 RL02 all VAX systems 
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2.1. Bootstrap Procedure for VAX- 11/730 from Tape Distribution 

Subsection 2.1 explains the bootstrap procedure for installing the ULTRIX-32 
software on a VAX- 11/730, from the distribution tape. 

This procedure should take between one and one and one half hours. 
Getting Started 

Before starting the bootstrap procedure, you must be familiar with your system 
configuration. If your system is under a Digital Field Service Contract, then you can 
obtain detailed configuration information from the Configuration Worksheet section of 
the Site Management Guide. 

You will need the following equipment: 

• The two ULTRIX-32 distribution tapes 

• The ULTRIX-32 distribution cassette 

• One blank cassette 

• Formatted disk pack(s) 

• VAX- 11/730 system with a tape drive and disk drive(s) 
Follow these steps to prepare the system for booting from tape: 

1) If your disk packs are removable (RK07, RA60), load a formatted disk pack into 
disk drive 0. (Digital Equipment Corporation disk packs are shipped Preformat- 
ted). Load any additional disk packs you may need as well, but the disk pack in 
drive 0 will be the root (or system) disk. 

Even if your pack is nonremoveable, be sure your system disk pack is spinning 
and that the READY light is lit, even if your disk pack is nonremovable. 

2) Load the first distribution tape (labeled BOOT TAPE) on tape drive 0. Be sure 
the tape drive is ON-LINE and that the tape is rewound to load point (BOT). 

3) Insert the distribution cassette into the console TU58 disk drive on the outside 
of the processor (drive 0). 

4) On the processor itself, set the restart switch to OFF and the rotary key switch 
to LOCAL. 

General Steps 

The tape bootstrap procedure to create a working system consists of the following gen- 
eral steps: 

1) Copy a miniroot filesystem from the tape onto the swap area of the disk. 
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2) Boot the ULTRIX-32 system on the miniroot. 

3) Restore the full root filesystem. 

4) Update a console cassette for bootstrapping. 

5) Reboot the completed root filesystem. 

6) Build and restore the / usr filesystem from tape. 

The next few subsections describe the these steps in detail. References to disk drives 
are of the form xx (n,m) and references to files on tape drives are of the form yy (n,m) 
where xx and yy are one of the names in the table below. 

n is usually 0 because it is equal to the unit number of the disk or tape drive; it 
specifies the logical unit number. 

m is always specified in the command lines of this document. For a disk, m is the 
partition (in the range 0-7). For a tape, m is the file number on the tape. 

Table 2.1.1 is a quick reference table for the disk and tape drive ULTRIX-32 system 
naming conventions. 

Table 2.1.1 ULTRIX-32 Disk and Tape Drive Naming Conventions 

Disk xx Tape yy 

RA60 ra TS11 ts 

RA80 ra TU80 ts 

RA81 ra 
RK07 hk 
R80 (IDC) rb 

If you have a DECwriter III (LA120), you must set up your console terminal before 
proceeding with the installation. 

To set up the console, hold down <SETUP> and press the D key simultaneously until 
the LED display on the console (at the upper left-hand corner of the keys) is 0 (zero). 

2.1.1. Copy the Miniroot Filesystem 

The first step is to run the program copy, which copies the miniroot filesystem from 
the second tape file of the first distribution tape into the second partition of the disk. 
This filesystem will serve as the base for creating the actual root filesystem. 
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The system must be halted; if it is not, type: 
»>H 

The console subsystem prompts with »>. To load the copy program, type the fol- 
lowing commands in response to the prompt. If you make a mistake typing, type 
<DELETE> to erase a character, <CTRL/U> to erase the line, or <CTRL/C> to 
interrupt the process. 

»>l (initialize the processor) 

»>L DD0:COPY (boot the cassette) 

(this takes about two minutes) 
»>S2 (start the copy program) 

From: yy(n,l) (from the distribution tape) 

To: xx(n,l) (to the disk pack) 

(this takes about one minute) 

Copy completed: 300 records copied 

From: T (<CTRL/P> returns you to the console 

subsystem) 

?02 FC=xxxxxxxx (program counter) 

»>I (initialize the processor) 

You now have the set of tools necessary to create a root filesystem and restore the 
filesystem contents from tape. 

2.1.2. Boot from the Miniroot Filesystem 

The second step is to load the bootstrap program and boot the ULTRIX-32 miniroot 
filesystem which you just copied to the disk: 

»>L DD0:BOOT (boot the cassette) 

(this takes about one minute) 
>»S2 (start the boot program) 

Boot 

: jcx(n,l)vmunix (boot the ULTRIX-32 kernel off the 

miniroot) 

(this takes about one minute) 



The standalone boot program then reads the ULTRIX-32 miniroot system (which you 
just created via the copy program) from the disk. The system then starts, displaying 
the following messages: 
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215564+64088+69764 start 0xf98 (these numbers are approximate) 
ULTRIX-32 date and time (this takes a minute) 

real mem = xxxxxx 
avail mem = yyy 



information about available devices 



root device? 



2.1.2.1. Explanation of System Boot Messages 

The first three numbers printed by the bootstrap programs are the sizes of different 
parts of the system (text, initialized and uninitialized data). 

The ULTRIX-32 system then runs for the first time, beginning with a banner identi- 
fying the release and version of the system that is in use, and the date it was com- 
piled. 

The mem messages give the amount of real (physical) memory and the memory avail- 
able to user programs in bytes. For example, if your machine has 4mb of memory, 
then xxxxxx will be 4190208, 4096 bytes less than 4mb. The system reserves the last 
4096 bytes of memory for use in logging system messages and does not count it as part 
of real memory. Available memory is the amount of physical memory left over for 
user processes after the ULTRIX-32 software has been loaded. 

Information about the system is shown next, followed by messages showing what dev- 
ices were found on the current processor. These messages are described in auto- 
con/(4). The distributed system may not find all the communications devices (dmf's 
and dz's), or mass storage peripherals if you have more than two of one device. This 
is corrected later when you create a description of your machine from which to 
configure the ULTRIX-32 system. These messages contain much of the information 
that will be used in creating the configuration. In a correctly configured system most 
of the information present in the configuration description is printed out at boot time 
as the system verifies that each device is present. 

You may receive a warning message about the date. The system is telling you that it 
realizes the date and time currently stored in memory are wrong. Do not worry about 
this message; you will be changing the date and time later (subsection 2.1.6). 
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2.1.2.2. Boot from the Miniroot Filesystem, Continued 

The "root device?" prompt asks for the name of the root filesystem to use: 



root device? xxO* 
erase kill A U, intr A C 
# 



The response xxO* supplies two pieces of information. First, xxO indicates the disk it 
is running on is drive 0 of type xx. Second, the * indicates the system is running atop 
the paging area. The * is very important because it prevents the system from 
attempting to page on top of itself. 

NOTE: If at any time the miniroot filesystem requires rebooting, be sure to copy the 
miniroot first (see subsection 2.1.1). 

The shell executes /.profile when it starts, which inturn generates the erase ... message. 
This message reminds you that <DELETE> is the erase character, <CTRL/U> is the 
erase line character (kill), and <CTRL/C> is the interrupt character. 

2.1.3. Restore the Root File System 

The ULTRIX-32 system is now running. The # is the prompt from the shell, and lets 
you know that you are the superuser, whose login name is root. 

The third step is to create the root filesystem. To do this, execute the xtr shell script 
by typing: 

# disk=xxO type=dddd tape=yy xtr 

where xxO is the name of the disk drive (unit 0), dddd is the type of disk drive on 
which the root filesystem is to be restored and yy is the name of the tape drive from 
which the distribution tape is loaded (see Table 2.1.2). Table 2.1.2 is a reference of 
the disk and tape drive ULTRIX-32 system naming conventions. 

Table 2.1.2 ULTRIX Disk and Tape Drive Naming Conventions 

Tape yy 



Disk 


XX 


dddd 


RA60 


ra 


ra60 


RA80 


ra 


ra80 


RA81 


ra 


ra81 


RK07 


hk 


rk07 


R80 (IDC) 


rb 


rb80 



TS11 ts 
TU80 ts 
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For example, if you have an RK07 disk drive and a TU80 tape drive, type: 
# disk=hkO type=rk07 tape=ts xtr 

The xtr script generates messages regarding the construction of the filesystem and the 
restoration of the tape contents. You may receive a warning giving the inode 
blocks/cylinder group and its implications; disregard this message. The messages will 
eventually terminate with the following: 



Root filesystem extracted 

If this is a 780, update floppy 

If this is a 730, update the cassette 

# 

Check the consistency of the root filesystem by typing: 

* fsck /dev/rxxOa (xx is from Table 2.1.2) 
The output from fsck should look similar to: 

** /dev/rxxOa 

* * Last Mounted on / 

* * Phase 1 - Check Blocks and Sizes 

* * Phase 2 - Check Pathnames 

* * Phase 3 - Check Connectivity 

* * Phase 4 - Check Reference Counts 

* * Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 



2.1.4. Update the Console Cassette 

The fourth step is to build an ULTRIX-32 boot cassette by copying some files from 
the local console cassette (that is, the cassette which came with your hardware), 
adding some files from the ULTRIX-32 system and writing them all to a blank 
cassette. 

This new boot cassette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First, remove the distribution cassette from the external TU58 drive (drive 0) and 
insert a blank cassette. Be sure the blank cassette is NOT write protected (the record 
tab is in the left-most position). 
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Make sure the local console cassette is loaded in the internal TU58 drive (drive 1). To 
locate this drive, pull out the front of the CPU like a desk drawer, and you will find 
drive 1 on the back right-hand side. 

Then, change into the directory where the console cassette information is stored: 

# cd / sys/ cassette 

Next set up the default boot device. If you intend to use an IDC R80 as your primary 
root type: 

# cp defboo.rb defboo.cmd 

If you intend to use an RK07 as your primary root type: 

# cp defboo.hk defboo.cmd 

If you intend to use a drive on a UDA50 as your primary root type: 

# cp defboo.ra defboo.cmd 

To build the updated boot cassette, type: 

# make update 



(this takes about 25 minutes) 



lists all of the files on the cassette 



Console cassette update complete. 

The new cassette should be installed in the internal 

tu58 slot (Drive 1). 

# 

# 

Store the distribution cassette and the local console cassette in a safe place. The ori- 
ginal local console will be required to boot VAX/VMS systems. Remove the boot 
cassette you just built from the external drive, and insert it in the internal TU58 
cassette drive (drive 1). 

At this point, you can make more copies of the new boot cassette by using the flcopy 
maintenance command (see arff(8V)). 



\ 
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2.1.5. Reboot the Completed Root File System 

The fifth step is to reboot the system. To do this, type the following commands. If 
you make a mistake typing, type <DELETE> to erase a character, <CTRL/U> to 
erase the line, or <CTRL/C> to interrupt the process. 



# sync (flush incore buffers to disk) 

# sync 

# "P (<CTRL/P> returns you to the console 

subsystem) 

?02 PC=xxxxxxxx (program counter) 

>» (initialize processor) 

»>B ANY 

(boot program is eventually loaded) 



boot program messages appear 



Boot 

'. %x(x,0)vmunix 

215564+64088+69764 start 0xf98 



(boot the ULTRIX-32 kernel off root) 

(this takes a minute) 

(these numbers are approximate) 



ULTRIX-32 date and time 
real mem = xxxxxx 
avail mem = yyy 



information about available devices 
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root device? xxO 
erase kill A U, intr "C 
# 

If the system does not reboot properly, see Appendix C for help with troubleshooting. 

The system is running in single-user mode on the installed root filesystem. The # 
prompt is from the ULTRIX-32 operating system, and tells you that you are the 
superuser. 

The next subsection tells how to complete the installation of distributed software for 
the / usr filesystem. 

2.1.6. Set up and Install the /usr Filesystem 

The last step is to build and restore the /usr filesystem. 

First, set a shell variable to the name of your disk drive so the commands given will 
work regardless of the drive you have. To do this, find your disk drive in the follow- 
ing list and type the command to the right: 



Disk Drive 


Command 


RA60 


disk=ra 


RA80 


disk=ra 


RA81 


disk=ra 


RK07 


disk=hk 


R80 (IDC) 


disk=rb 



For example, if you have an RK07, type: 
# disk=hk 

The next two commands select a partition for /usr. If you have more drives available, 
see subsection 5.1 (Fine Tuning the Disk Configuration) to help decide if some other 
partition might be more appropriate. 

The partitions in the list below are those most appropriate in size. Find your disk in 
the list and type the commands to the right: 
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Disk Command s 



RA60 name=raOh; type=ra60 

RA80 name=raOh; type=ra80 

RA81 name=raOh; type=ra81 

RK07 name=hkOg; type=rk07 

R80 name=rbOh; type=rb80 



For example, if you have an RK07, type: 

# name=hkOg; type=rk07 

Next, find your tape drive in the following list and type the commands to the right. 
Tape Drive Commands 

TS11 cd /dev; MAKEDEV tsO; sync 

TU80 cd /dev; MAKEDEV tsO; sync 

For example, if you have a TU80, type: 

# cd /dev; MAKEDEV tsO; sync 

Now set the date and time: 

# date yymmddhhmm 
Where: 

yy equals the last two digits of the year 

mm equals the number of the month of the year 

dd equals the number of the day of the month 

hh equals the hour of the day (based on 24 hours) 

mm equals the minutes of the hour 

(the system echos the new date and time) 

Next, set the superuser password. The password you select must contain at least 
characters: 

# passwd root (set password for superuser) 
New password: (password will not echo) 
Retype new password: 

# 
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Now create an empty user filesystem by typing: 

# newfs ${name} ${type} (remember to type the braces ({})) 

(this takes a few minutes) 



newfs lists all the filesystem parameters for /usr. Save the super-block numbers. 
Tape them to the outside of the disk pack cover. If your pack is nonremovable, tape 
the numbers to the outside of the drive. Then continue with the following commands: 

# mt rew (rewind the magnetic tape) 

# mount /dev/${name} /usr (mount the /usr filesystem) 

# cd /usr (make /usr the current directory) 

# mkdir sys (make directory for system objects) 

If your system disk is an RK07, be sure your second pack is loaded onto the second 
drive (drive 1), and spinning, and the READY light is lit. Then type 

# newfs hk1a rk07 

newfs will print all the filesystem partitions for /usr /sys. Save these numbers as you 
did above. Then type: 

# mount /dev/hk1a /usr/sys 

Continue with the following commands for all system disks, including RK07s: 



# cd sys 

# mt fsf 3 

# tar xpbf 20 /dev/rmt12 



(make /usr/sys the current directory) 
(wind the magnetic tape forward three 
files) 

(extract the system source 
(this takes about 5-10 minutes) 



# cd .. 

# mt fsf 

# tar xpbf 20 /dev/rmtl2 

# cd/ 

# chmod 755 /usr/sys 
# 



(make /usr the current directory) 

(extract all of usr except /usr/src) 
(this takes about 15-20 minutes) 
(make / (root) the current directory) 
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If you have an RK07 as your system disk, type: 

# umount /dev/hk1a 

Continue with the following for all system disks, including RK07s: 

# umount /dev/${name} (unmount /usr) 

Check the consistency of the /usr filesystem by typing: 

# fsck /dev/r${name} 

The output from fsck should look similar to: 

** /dev/rxxOh 

** Last Mounted on /usr 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 
If your system disks are RK07s, check the consistency of the /usr/sys hie on drive 1 

# fsck /dev/rhk.1a 

The output from fsck should look similar to: 

** Last Mounted on /usr/sys 

** Phase 1 - Check Blocks and sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

864 files, 3745 used, 3678 free (134 frags, 433 blocks) 



If there are inconsistencies in the filesystems, the system may prompt you for correc- 
tive action; see fsck — the UNIX File System Check Program for further information. 
If serious problems exist, try the extractions again, starting with the newfs ${name} 
${type} command above. 
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Now remount the / usr filesystem by typing: 

# /etc/mount / dev/${name} /usr 

If your system disks are RK07s, you also need to remount the /usr/sys filesystem. To 
do this type: 

# /etc /mount /dev/hk1a /usr/sys 

You have now extracted all the data on the first distribution tape. Unload the first 
tape from the tape drive, and store it in a safe place. You will be extracting the files 
from the second distribution tape later in subsection 4.5. 

The ULTRIX-32 operating system is bootstrapped and running in single-user mode. 
See section 3 (System Setup) for information on how to further set up your system. 



\ 
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2.2. Bootstrap Procedure for VAX- 11/750 from Tape Distribution 

Subsection 2.2 explains the bootstrap procedure for installing the ULTRIX-32 
software on a VAX- 11/750, from the distribution tape. 

This procedure should take between half an hour and a full hour to complete. 
Getting Started 

Before starting the bootstrap procedure, you must be familiar with your system 
configuration. You must know which hardware devices are connected to which con- 
trollers, naming conventions, unit numbers, and so forth. If your system is under a 
Digital Service Contract, then you can obtain detailed configuration information from 
the Configuration Worksheet section of the Site Management Guide. 

You will need the following equipment: 

• The two ULTRIX-32 distribution tapes 

• The ULTRIX-32 distribution cassette 

• Formatted disk pack(s) 

• VAX-1 1/750 system with a tape drive and a disk drive(s) 

Follow these steps to prepare your system for booting from tape: 

1) Load a formatted disk pack into disk drive 0 if your disk packs are removable 
(Digital Equipment Corporation disk packs are shipped pref or matted). Load any 
additional disk packs you may need as well. Remember, the disk pack on drive 0 
will be the root (or system) disk. 

Even if your disk pack is nonremovable, be sure your system disk pack is spinning 
and that the READY light is lit. 

2) Load the first distribution tape (labeled BOOT TAPE) on tape drive 0. Be sure 
the tape drive is ON-LINE and READY, and that the tape is rewound to load 
point (BOT). 

3) Insert the distribution cassette into the console TU58 disk drive on the front of the 
processor (drive 0). 

4) On the processor itself, set the power-on action switch to HALT and the rotary key 
switch to LOCAL. 



It makes no difference how the boot device switch is set during the installation. 
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General Steps 

The tape bootstrap procedure to create a working system consists of these steps: 

1) Copy a miniroot filesystem from the tape onto the swap area of the disk. 

2) Boot the ULTRIX-32 system on the miniroot. 

3) Restore the full root filesystem. 

4) Reboot the completed root filesystem. 

5) Build and restore the /usr filesystem from tape. 

The next few subsections describe these steps in detail. References to disk drives are 
of the form xx(n,m) and references to files on tape drives are of the form yy(n,m) 
where xx and yy are one of the names in Table 2.2.1. 

For UNIBUS devices, n is usually 0 because it is equal to the unit number of the disk 
or tape drive. 

For MASSBUS devices, n is computed as follows: 

n = 8 * (mba) + (device unit number) 

For example, if drive 0 were on the first MASSBUS adapter (mbaO) then n would be 
0; if drive 0 were on the second MASSBUS adapter (mbal) then n would be 8. 

The m is always specified in the command lines of this document. For a disk, m is the 
partition (in the range 0-7). For a tape, m is the file number on the tape. 

Table 2.2.1 is a quick reference table for the disk and tape drive ULTRIX-32 system 
naming conventions. 

Table 2.2.1 Disk and Tape Drive Naming Conventions 



Disk 


XX 


Tape 


yy~ 


RA60 


ra 


TE16 


ht 


RA80 


ra 


TS11 


ts 


RA81 


ra 


TU77 


ht 


RK07 


hk 


TU78 


mt 


RL02 


rl 


TU80 


ts 


RM03 


hp 






RM05 


hp 






RM80 


hp 






RP06 


hp 







If you have a DECwriter III (LAI 20), you must set up your console terminal before 
proceeding with the installation. 

To set up the console, hold down <SETUP> and press D simultaneously until the 
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LED display on the console (at the upper left-hand corner of the keys) is 0 (zero). 

2.2.1. Copy the Miniroot Filesystem 

The first step uses the copy program to copy the miniroot filesystem from the second 
tape file of the first distribution tape into the second partition of the disk. This 
filesystem will serve as the base for creating the actual root filesystem. 

The system must be halted; if it is not, type: 
"P 

»>H 

The console subsystem prompts with >>>. To load the copy program, type the fol- 
lowing in response to the prompt. If you make a typing mistake, type <DELETE> to 
erase a character, <CTRL/U> to erase the line, or <CTRL/C> to interrupt the pro- 
cess. 



»>B DDAO 

%% 

= copy 

From: yy{n,~\) 
To: xx(n,l) 

Copy completed: 300 records copied 
From: T 



>» I 



(initialize the processor) 
(boot the cassette) 

(signifies the beginning and completion 

of diagnostics) 

(start the copy program) 

(this takes a few minutes) 

(from the distribution tape to the disk pac 

(this takes about five minutes) 

(<CTRL/P> returns you to the console 
subsystem) 

(program counter) 
(initialize the processor) 



2.2.2. Boot from the Miniroot Filesystem 

You now have the minimal set of tools necessary to create a root filesystem and 
restore the filesystem contents from tape. 

The second step is to load the bootstrap program and boot the ULTRIX-32 miniroot 
system which you just copied to the disk. To do this, type: 



22 ULTRIX-32 Installation Guide 

»>B DDAO 

%°/o 
= boot 

Boot 

: xx(n, 1)vmunix 



(boot the cassette) 

(this takes about one minute) 

(start the boot program) 
(this takes about one minute) 

(boot the ULTRIX-32 kernel off the 
miniroot) 



The standalone boot program then reads the ULTRIX-32 miniroot system (which you 
just created with the copy program) from the disk. The system then starts, displaying 
the following messages: 



Updating 1 1 /750 micro code... 

215564+64088+69764 start 0xf98 
ULTRIX-32 (.date and time) 
real mem = xxxxxx 
avail mem = yyy 



(appears if you are running 
revision 5 or greater) 
(these numbers are approximate) 
(this takes a minute) 



information about available devices 



root device? 



ULTRIX-32 Installation Guide 23 



2.2.2.1. Explanation of System Boot Messages 

The first three numbers printed by the bootstrap programs are the sizes of different 
parts of the system (text, initialized and uninitialized data). 

The ULTRIX-32 system then runs for the first time, beginning with a banner identi- 
fying the release and version of the system that is in use and the date it was compiled. 

The mem messages give the amount of real (physical) memory and the memory avail- 
able to user programs in bytes. For example, if your machine has 4mb of memory, 
then xxxxxx will be 4190208, 4096 bytes less than 4mb. The system reserves the last 
4096 bytes of memory for use in logging system messages and does not count it as part 
of real memory. Available memory is the amount of physical memory left over for 
user processes after the ULTRIX-32 software has been loaded. 

Information about the system is shown next, followed by messages showing what dev- 
ices were found on the current processor. These messages are described in auto- 
conf(4). The distributed system may not have found all the communications devices 
(dmfs and dzs), or mass storage peripherals you have if you have more than two of one 
device. This is corrected later when you create a description of your machine from 
which to configure the ULTRIX-32 system. These messages contain much of the 
information that will be used in creating the configuration. In a correctly configured 
system most of the information present in the configuration description is printed out 
at boot time as the system verifies that each device is present. 

You may receive a warning message about the date. The system is telling you that it 
realizes the date and time currently stored in memory are wrong. Do not worry about 
this message; you will be changing the date and time later (subsection 2.2.5). 

2.2.2.2. Boot from the Miniroot Filesystem, Continued 

The root device? prompt asks for the name of the root filesystem to use: 



root device? xxO* 
erase A ? f kill U, intr A C 
# 

The xxO* response supplies two pieces of information. First, xxO indicates the disk is 
running on drive 0 of type xx. Second, the * indicates the system is running atop the 
paging area. The * is very important because it prevents the system from attempting 
to page on top of itself. 

NOTE: If at any time the miniroot requires rebooting, be sure to copy the miniroot 
first (see subsection 2.2.1). 
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The shell executes /.profile, which in turn generates the "erase ..." message. This mes- 
sage informs you that <DELETE> is the erase character, <CTRL/U> is the erase 
line character (kill), and <CTRL/C> is the interrupt character. 

The ULTRIX-32 system is now running. The # is the prompt from the shell, and lets 
you know that you are the superuser, whose login name is root. 

2.2.3. Restore the Root Filesystem 

The third step is to create the root filesystem. To do this, run the xtr shell script by 
typing: 

# disk=:cxO \ype=dddd tape=yy xtr 

where xxO is the name of the disk drive (unit 0), dddd is the type of disk drive on 
which the root filesystem is to be restored and yy is the name of the tape drive from 
which the distribution tape is mounted (see Table 2.2.2). Table 2.2.2 is a quick refer- 
ence of the disk and tape drive ULTRIX-32 system naming conventions. 

Table 2.2.2 ULTRIX-32 Disk and Tape Drive Naming Conventions 



Disk 


XX 


dddd 


Tape 




RA60 


ra 


ra60 


TE16 


ht 


RA80 


ra 


ra80 


TS11 


ts 


RA81 


ra 


ra81 


TU77 


ht 


RK07 


hk 


rk07 


TU58 


tu 


RM03 


hp 


rm03 


TU80 


ts 


RM05 


hp 


rm05 






RM80 


hp 


rm80 






RP06 


hp 


rp06 







For example, if you have an RK07 disk drive and a TU80 tape drive, type: 
# disk=hkO type=rk07 tape=ts xtr 

The xtr script generates messages regarding the construction of the filesystem and the 
restoration of the tape contents. You may receive a warning giving the inode 
blocks/cylinder and its implications; disregard this message. The messages eventually 
terminate with the following: 
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(this takes about five minutes) 



Root filesystem extracted 

If this is a 780, update floppy 

If this is a 730, update the cassette 

# 

NOTE: The VAX- 11/750 does not use console media for rebooting. Therefore, you do 
not need to build a new console boot cassette. 

Check the consistency of the root filesystem by typing: 

* fsck /dev/rxxOa (xx is found in Table 2.2.2) 
The output from fsck should look similar to: 

** /dev/rxxOa 

* * Last Mounted on / 

* * Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 

* * Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

* * Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 



2.2.4. Reboot the Completed Root Filesystem 

The fourth step is to reboot the system. To do this, type the following commands. If 
you make a mistake typing, type <DELETE> to erase a character, <CTRL/U> to 
erase the line, or <CTRL/C> to interrupt the process. 



# sync (flush incore buffers to disk) 

# sync 

# "P (<CTRL/P> return you to console 

subsystem) 

xxxxxxxx 02 (program counter) 

>>> (initialize processor state) 

»> B/3 ddcu (see the following table for an 

explanation of ddcu) 



Table 2.2.3 is a quick reference to help you fill the variable ddcu in the command 
above. Find your kind of disk drive in the table, and use the ddcu to the right. 
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Table 2.2.3 Disk Drives and their Device Type Codes 

Disk Drive ddcu 

RA60 DXJcu 

RA80 DUcu 

RA81 DUcu 

RK07 DMcu 

RM03 DBcu 

RM05 DBcw 

RM80 DBcu 

RP06 DBcu 

ddcu is the general format for device names, and is computed as follows: 

dd The first two characters are the disk drive device designator. 

c The third character is the controller to which the boot drive is connected. It is 
usually A. If the controller unit number is 0 then c is A, if the unit number is 1 
then c is B, and if the unit number is 2 then c is C. 

u The fourth character is the disk drive unit number. This number can be found 
on the front panel of the disk drive unit. 

After supplying the correct ddcu, continue rebooting the system as follows: 

%% (signifies beginning and successful 

completion of diagnostics) 

(boot program is eventually loaded) 



(c is usually A for each 
of the drives listed, u is 
equal to the drive number. See 
below for further information.) 



boot program messages appear 



Boot 

: xx(n,0)vmunix 

215564+64088+69764 start 0xf98 



(boot the ULTRIX-32 kernel off root) 

(this takes a minute) 

(these numbers are approximate) 
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real mem = xxx 
avail mem = yyy 



information about available devices 



root device? xxO 
erase A ?, kill TJ, intr A C 
# 

If the system does not reboot properly, see Appendix C for help with troubleshooting. 

The system is running in single-user mode on the installed root filesystem. The # 
prompt is from the ULTRIX-32 operating system, and tells you that you are the 
superuser. 

The next subsection tells how to complete the installation of distributed software for 
the / usr filesystem. 

2.2.5. Set up and Install the /usr Filesystem 

The last step is to build and restore the /usr filesystem. 

First, set a shell variable to the name of your disk drive so the commands given will 
work regardless of your drive. To do this, find your disk drive in the following list, 
and enter the command to the right: 



Disk Drive 


Command 


RA60 


disk=ra 


RA80 


disk=ra 


RA81 


disk=ra 


RK07 


disk=hk 


RM03 


disk = hp 


RM05 


disk = hp 


RM80 


disk = hp 


RP06 


disk=hp 
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For example, if you have an RK07, type: 
# disk=hk 

The next two commands select a partition for /usr. If you have more drives available, 
see subsection 5.1 (Fine Tuning the Disk Configuration) to help decide if some other 
partition might be more appropriate. 

The partitions below are those most appropriate in size. Find your disk in the follow- 
ing list and type the commands to the right: 



For example, if you have an RK07, then you would type name=hkOg; type=rk07. 
Next, find your tape drive in the following list, and enter the commands to the right: 



Dkk_ 

RA60 

RA80 

RA81 

RK07 

RM03 

RM05 

RM80 

RP06 



Commands 



name=raOh; type=ra60 
name=raOh; type=ra80 
name=raOh; type=ra81 
name=hkOg; type=rk07 
name=hpOg; type=rm03 
name=hpOg; type=rm05 
name=hpOg; type=rm80 
name=hpOg; type=rp06 



Tape Drive 



Commands 



TE16 
TS11 
TU45 
TU77 
TU78 
TU80 



cd /dev; MAKEDEV htO; sync 
cd /dev; MAKEDEV tsO; sync 
cd /dev; MAKEDEV htO; sync 
cd /dev; MAKEDEV htO; sync 
cd /dev; MAKEDEV mtO; sync 
cd /dev; MAKEDEV tsO; sync 



For example, if you have a TU80, type: 



# cd /dev; MAKEDEV tsO; sync 



Now set the date and time: 



# date yymmddhhmm 
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Where: 

yy equals the last two digits of the year 

mm equals the number of the month of the year 

dd equals the number of the day of the month 

hh equals the hour of the day (based on 24 hours) 

mm equals the minutes of the hour 



(the system echos the new date and time) 

Next, set the superuser password. The password you select must contain at least six 
characters: 



Retype new password: 
Now create an empty user filesystem by typing: 



newfs lists all the filesystem partitions for /usr. Save the super-block numbers. Tape 
them to the outside of the disk pack cover. If your pack is nonremovable, tape the 
numbers to the outside of the drive. 

Then continue with these commands: 



# passwd root 
New password: 



(set password for superuser) 
(password will not echo) 



# newfs ${name} ${type} 



(remember to type the braces ({ })) 
(this takes a few minutes) 



# cd /usr 

# mkdir sys 



# mt rew 

# mount /dev/${name} /usr 



(rewind the magnetic tape) 
(mount the usr filesystem) 
(remember to type the braces) 
(make /usr the current directory) 
(make directory for system objects) 



If your system disk is an RK07, be sure your second pack is loaded onto the second 
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drive (drive 1), and spinning, and the READY light is lit. Then type: 

# newts hk1a rk07 

newfs prints all the filesystem partitions for /usr/sys. Save these numbers as you did 
above. Then enter this command: 

# mount /dev/hk1a /usr/sys 

Continue with the following commands for all system disks, including RK07s: 

# cd sys (make /usr/sys the current directory) 

# mt fsf 3 (wind the magnetic tape forward three 



# tar xpbf 20 /dev/rmt12 



files; this takes a minute) 
(extract the system source) 



(this takes 5-10 minutes) 



# cd .. 

# mt fsf 

# tar xpbf 20 /dev/rmt12 



(make /usr the current directory) 



(extract all of usr except /usr/src) 



(this takes 15-20 minutes) 



# cd / 

# chmod 755 /usr/sys 



(make / (root) the current directory) 



If your system disks are RK07s, enter the following: 



# urn our.* 



/dfev/hk1a 



Then continue with the following for all system disks, including RK07s: 



# umount /dev/${name} 



(unmount /usr; remember to type the 
braces) 



# 



Check the consistency of the / usr filesystem by typing: 
# fsck /dev/r${name} 
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The output from fsck should look similar to: 

** /dev/rxxOh 

** Last Mounted on /usr 

* * Phase 1 - Check Blocks and Sizes 

* * Phase 2 - Check Pathnames 

* * Phase 3 - Check Connectivity 

* * Phase 4 - Check Reference Counts 

* * Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 

If your system disks are RK07s, check the consistency of the /usr/sys file on drive 1 by 
typing 

* fsck /dev/rhk1a 

The output from fsck should look similar to: 
** /dev/rhk1a 

** Last Mounted on /usr/sys 

* * Phase 1 - Check Blocks and sizes 

* * Phase 2 - Check Pathnames 

* * Phase 3 - Check Connectivity 

* * Phase 4 - Check Reference Counts 

* * Phase 5 - Check Cyl groups 

864 files, 3745 used, 3678 free (134 frags, 433 blocks) 

If there are inconsistencies in the filesystems, the system may prompt you for correc- 
tive action. See fsck — the UNIX File System Check Program for further informa- 
tion. If serious problems exist, try the extractions again, starting with the newfs 
${name} ${type} command above. 

Now remount the / usr filesystem by entering: 

* /etc/mount /dev/${name} /usr 

If your system disks are RK07s, you also need to remount the /usr/sys filesystem. To 
do this enter: 

* /etc /mount /dev/hk1a /usr/sys 

You have now extracted all of the data on the first distribution tape. Unload the first 
tape from the tape drive, and store it in a safe place. You will be extracting the files 
from the second distribution tape later in subsection 5.5. 

The ULTRIX-32 system is bootstrapped and running in single-user mode. See section 
3 (System Setup) for information on how to further set up your system. 
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2.3. Bootstrap Procedure for VAX- 11/780 from Tape Distribution 

Subsection 2.3 explains the bootstrap procedure for installing the ULTRIX-32 
software on a VAX-11/780, from the distribution tape. 

This procedure should take between one hour and one and one half hours to complete. 
Getting Started 

Before starting the bootstrap procedure, you must be familiar with your system 
configuration. You must know which hardware devices are connected to which con- 
trollers, naming conventions, unit numbers, and so forth. If your system is under a 
Digital Field Service Contract, then you can obtain detailed configuration information 
from the Configuration Worksheet section of the Site Management Guide. 

You will need the following equipment: 

• The Two ULTRIX-32 distribution tapes 

• The ULTRIX-32 distribution floppy diskette 

• One blank floppy diskette 

• Formatted disk pack(s) 

• VAX-11/780 system with a tape drive and disk(s) 

The following steps are required to prepare the system for booting from tape: 

1) If your disk packs are removable, load a formatted disk pack into disk drive 0. 
(All Digital Equipment Corporation disk packs are shipped pre-formatted.) Load 
any additional packs you may need as well, but the pack on drive 0 will be the root 
(or system) disk. 

Even if your disk pack is nonremoveable, be sure your system disk pack is spinning 
and that the READY light is lit, even if your pack is nonremovable. 

2) Load the first distribution tape (labeled BOOT TAPE) on tape drive 0. Be sure 
the tape drive is ON-LINE and READY, and that the tape is rewound to load 
point (BOT). 

3) Insert the distribution floppy diskette into the console floppy inside the proces- 
sor (drive 0). (Note that the floppy diskette label points toward the handle of the 
floppy diskette drive.) 

4) On the processor itself, set the auto restart switch to OFF and the rotary key 
switch to LOCAL. 
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General Steps 

The tape bootstrap procedure to create a working system consists of the following gen- 
eral steps: 

1) Copy a miniroot filesystem from the tape onto the swap area of the disk. 

2) Boot the ULTRIX-32 system on the miniroot. 

3) Restore the full root filesystem. 

4) Update a console floppy diskette for bootstrapping. 

5) Reboot the completed root filesystem. 

6) Build and restore the /usr filesystem from tape. 

The next few subsections describe these steps in detail. References to disk drives are 
of the form xx(n,m) and references to files on tape drives are of the form yy(n,m) 
where xx and yy are one of the names given in the table below. 

For UNIBUS devices, n is usually 0 because it is equal to the unit number of the disk 
or tape drive. For MASSBUS devices, n is computed as follows: 

n = 8 * (mba) + (device unit number) 

For example, if drive 0 were on the first MASSBUS adapter (mbaO) then n would be 
0; if drive 0 were on the second MASSBUS adapter (mbal) then n would be 8. 

m is always specified in the command lines of this document. For a disk, m is the 
partition (in the range 0—7). For a tape, m is the file number on the tape. 

Table 2.3.1 is a quick reference table for the disk and tape drive ULTRIX-32 system 
naming conventions: 

Table 2.3.1 Disk and Tape Drive Naming Conventions 



Disk 


XX 


Tape 




RA60 


ra 


TE16 


ht 


RA80 


ra 


TS11 


ts 


RA81 


ra 


TU77 


ht 


RK07 


hk 


TU78 


mt 


RL02 


rl 


TU80 


ts 


RM03 


hp 






RM05 


hp 






RM80 


hp 






RP06 


hp 






RP07 


hp 







If you have a DEC writer III (LA 120), you must set up your console terminal before 
proceeding with the installation. 

To set up the console, hold down <SETUP> and press the D key simultaneously until 
the LED display on the console (at the upper left-hand corner of the keys) is 0 (zero). 
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2.3.1. Copy the Miniroot Filesystem 

The first step is to run the program copy, which copies the miniroot filesystem from 
the second tape file of the first distribution tape into the second partition of the disk. 
This filesystem will serve as the base for creating the actual root filesystem. 

The system must be halted; if it is not, type: 
»>H 

The console subsystem prompts with »>. To load the copy program, type the fol- 
lowing in response to the prompt. If you make a typing mistake, type <DELETE> to 
erase a character, <CTRL/U> to erase a line, or <CTRL/C> to interrupt the process. 



»>H (halt the processor) 

(a VAX- 11/780 can be in the console subsystem, but not be halted) 

HALTED AT xxxxxxxx (program counter) 

»>UNJAM ("unjam" the SBI) 

»>I (initialize the processor) 

INIT SEQ DONE 

»>LOAD COPY (boot the floppy diskette) 

(this takes about two minutes) 

LOAD DONE, xxxxxxxx BYTES LOADED 
»> START 2 (start the copy program) 

From: yy(n,l) (from the distribution tape) 

To: xx(n,l) (to the disk pack) 

(this takes about five minutes) 

Copy completed: 300 records copied 

FromfP (<CTRL/P> returns you to the console 

subsystem) 

H (halt the processor) 

HALTED AT xxxxxxxx (program counter) 

»> 

You now have the set of tools necessary to create a root filesystem and restore the 
filesystem contents from tape. 
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2.3.2. Boot from the Miniroot Filesystem 

The second step is to load the bootstrap program and boot the ULTRIX-32 miniroot 
system which you just copied to the disk. To do this, type: 

»> B ANY (boot the floppy diskette) 

CPU HALTED 
INIT SEQ DONE 

LOAD DONE, xxxxxxxx BYTES LOADED 



Boot 

: xx(n,l)vmunix (boot the ULTRIX-32 kernel off the 

miniroot; this takes a minute) 



The standalone boot program then reads the ULTRIX-32 miniroot system (which you 
just created via the copy program) from the disk. The system then starts, displaying 
the following messages: 

215564+64088+69764 start 0xf98 (these numbers are approximate) 
ULTRIX-32 date and time (this takes a minute)) 

real mem = xxxxxx 
avail mem = yyy 



information about available devices 



root device? 
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2.3.2.1. Explanation of System Boot Messages 

The first three numbers printed by the bootstrap programs are the sizes of different 
parts of the system (text, initialized and uninitialized data). 

The ULTRIX-32 system then runs for the first time, beginning with a banner identi- 
fying the release and version of the system that is in use and the date it was compiled. 

The mem messages give the amount of real (physical) memory and the memory avail- 
able to user programs in bytes. For example, if your machine has 4mb of memory, 
then xxxxxx will be 4190208, 4096 bytes less than 4mb. The system reserves the last 
4096 bytes of memory for use in logging system messages and does not count it as part 
of real memory. Available memory is the amount of physical memory left over for 
user processes after the ULTRIX-32 software has been loaded. 

Information about the system is shown next, followed by messages showing what dev- 
ices were found on the current processor. These messages are described in auto- 
conf(4). The distributed system may not have found all the communications devices 
(dmf's and dz's), or mass storage peripherals you have if you have more than two of 
one device. This is corrected later when you create a description of your machine 
from which to configure the ULTRIX-32 system. These messages contain much of the 
information that will be used in creating the configuration. In a correctly configured 
system most of the information present in the configuration description is printed out 
at boot time as the system verifies that each device is present. 

You may receive a warning message about the date. The system is telling you that it 
realizes the date and time currently stored in memory are wrong. Do not worry about 
this message; you will be changing the date and time later (subsection 2.3.6). 

2.3.2.2. Boot from the Miniroot Filesystem, Continued 

The root device? prompt asks for the name of the root filesystem to use: 

root device? xxO* 
erase kill A U, intr A C 
# 

The response xxO* supplies two pieces of information. First, xxO indicates the disk it 
is running on is drive 0 of type xx. Second, the * indicates the system is running atop 
the paging area. The * is very important because it prevents the system from 
attempting to page on top of itself. 

NOTE: If at any time the miniroot filesystem requires rebooting, be sure to copy the 
miniroot first (see subsection 2.3.1). 

The shell executes /.profile when it starts, which in turn generates the erase ... mes- 
sage. This message informs you that <DELETE> is the erase character, <CTRL/U> 
is the erase line character (kill), and <CTRL/C> is the interrupt character. 
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The ULTRIX-32 system is now running. The # is the prompt from the shell, and lets 
you know that you are the superuser, whose login name is root. 

2.3.3. Restore the Root Filesystem 

The third step is to create the root filesystem. To do this, execute the xtr shell script 
by typing: 

# disk=xxO type=dddd \ape=yy xtr 

where xxO is the name of the disk drive (unit 0), dddd is the type of disk drive on 
which the root filesystem is to be restored and, yy is the name of the tape drive on 
which the distribution tape is mounted (see table below). The Table 2.3.2 is a quick 
reference of the disk and tape drive ULTRIX-32 system naming conventions: 

Table 2.3.2 ULTRIX-32 System Naming Conventions 



For example, if you have an RK07 disk drive and a TU80 tape drive, type: 
# disk=hkO type=rk07 tape=ts xtr 

The xtr script generates messages regarding the construction of the filesystem and the 
restoration of the tape contents. The messages will eventually terminate with the fol- 
lowing: 



D is k 

RA60 

RA80 

RA81 

RK07 

RM03 

RM05 

RM80 

RP06 

RP07 



xx dddd Tape yy 

ra ra60 TE16 ht 

ra ra80 TS11 ts 

ra ra81 TU77 ht 

hk rk07 TU78 mt 

hp rm03 TU80 ts 

hp rm05 



hp rm80 
hp rp06 
hp rp07 



(this takes about five minutes) 



Root filesystem extracted 



If this is a 780, update floppy 

If this is a 730, update the cassette 

# 
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Check the consistency of the root filesystem by typing: 

# fsck /dev/rxxOa (xx is found in Table 2.3.2) 
The output from fsck should look similar to: 

** /dev/rjejcOa 

# * Last Mounted on / 

** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 

# * Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 
2.3.4. Update the Console Floppy Diskette 

The fourth step is to build an ULTRIX-32 console floppy diskette. To do this, copy 
some files from the console floppy diskette, add some files from the ULTRIX-32 sys- 
tem and write them all to a blank diskette. 

The console floppy diskette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First remove the distribution diskette from the drive and store it in a safe place. 
Insert the VAX- 11/780 console floppy diskette. 

Then change into the directory where the console floppy diskette information is stored 
by typing: 

# cd /sys/floppy 

Then set up the default boot device. If you intend to use an RK07 as your primary 
root type: 

# cp defboo.hk defboo.cmd 

If you intend to use a drive on a UDA50 (for example, an RA81) as your primary root 
type: 

# cp defboo.ra defboo.cmd 
Otherwise type: 

# cp defboo.hp defboo.cmd 

NOTE: If the local configuration requires any changes in restar.cmd or defboo.cmd 
(for example, for interleaved memory controllers), these should be made now. 

Type the following command to build the updated boot floppy diskette: 
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# make update 



lists all the files on the hardware floppy diskette 



Change Floppy, Hit return when done. 

Remove the VAX- 11/780 console floppy diskette, insert a blank (scratch) diskette, and 
press the <RETURN> key. To complete the procedure, respond with yes to the 
system's next question. 



Are you sure you want to clobber the floppy? yes 



lists all the files on the new boot floppy diskette 



# 

You can make more copies of the boot floppy diskette by using the f I copy maintenance 
command (see arff(8V). 

2.3.5. Reboot the Completed Root Filesystem 

The fifth step is to reboot the system. To do this, type the following commands. If 
you make a mistake typing, type <DELETE> to erase a character, <CTRL/U> to 
erase the line, or <CTRL/C> to interrupt the process. 



# sync 

# sync 

# T 

»>H 

HALTED AT xxxxxxxx 
»>U 
»>I 

INIT SEQ DONE 
»>B ANY 

(boot program is evem 
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(flush incore buffers to disk) 

(CTRL/P returns you to the console 

subsystem) 

(halt the processor) 

("unjam" the SBI) 
(initialize processor state) 

r loaded) 



boot program messages appear 



Boot 

: xx(n,0)vmunix (boot the ULTRIX-32 kernel off the 

root; this take about one minute) 



ULTRIX-32 date and time 
real mem = xxx 
avail mem = yyy 



information about available devices 



root device? xxO 
erase kill A U, intr A C 
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# 

If the system does not reboot properly, see Appendix C for help with troubleshooting. 

The system is running in single-user mode on the installed root filesystem. The # 
prompt is from the ULTRIX-32 operating system, and tells you that you are the 
superuser. 

The next subsection tells how to complete the installation of distributed software for 
the / usr filesystem. 

2.3.6. Set up and Install the /usr Filesystem 

The last step is to build and restore the / usr filesystem. 

First, set a shell variable to the name of your disk drive so the commands given will 
work regardless of the drive you have. To do this, find your disk drive in the follow- 
ing list, and type the command to the right: 



Disk Drive 


Command 


RA60 


disk=ra 


RA80 


disk=ra 


RA81 


disk=ra 


RK07 


disk=hk 


RM03 


disk = hp 


RM05 


disk = hp 


RM80 


disk = hp 


RP06 


disk = hp 


RP07 


disk = hp 



For example, if you have an RK07, type: 
# disk=hk 

The next two commands select a partition for / usr. If you have more drives available, 
see subsection 5.1 (Fine Tuning the Disk Configuration) to help decide if some other 
partition might be more appropriate. 

The partitions used below are those most appropriate in size. Find your disk in the 
following list, and type the commands to the right: 



ULTRIX-32 Installation Guide 43 



Disk Commands 



RA60 name=raOh; type=ra60 

RA80 name=raOh; type=ra80 

RA81 name=raOh; type=ra81 

RK07 name=hkOg; type=rk07 

RM03 name=hpOg; type=rm03 

RM05 name=hpOg; type=rm05 

RM80 name=hpOg; type=rm80 

RP06 name=hpOg; type=rp06 

RP07 name=hpOh; type=rp07 



For example, if you have an RK07, type: 
# name=hkOg; type=rk07 

Next, find your tape drive in the following list, and type the commands to the right: 

Tape Drive Commands 



TE16 
TS11 
TU77 
TU78 
TU80 



cd /dev; MAKEDEV htO; sync 
cd /dev; MAKEDEV tsO; sync 
cd /dev; MAKEDEV htO; sync 
cd /dev; MAKEDEV mtO; sync 
cd /dev; MAKEDEV tsO; sync 



For example, if you have a TU80, type: 

# cd /dev; MAKEDEVtsO; sync 

Now set the date and time: 

# date yymmddhhmm (set date) 



Where: 

yy equals the last two digits of the year 

mm equals the number of the month of the year 

dd equals the number of the day of the month 

hh equals the hour of the day (based on 24 hours) 

mm equals the minutes of the hour 

(the system echos the new date and time) 
Next, set the superuser password. The password you select must contain at least six 
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characters: 

# passwd root (set password for superuser) 
New password: (password will not echo) 
Retype new password: 

# 

Now create an empty user filesystem by typing: 

# newfs ${name} ${type} (remember to type the braces ({})) 

(this takes a few minutes) 



newfs lists all the filesystem parameters for /usr. Save the super-block numbers. 
Tape them to the outside of the disk pack cover. If your pack is nonremovable, tape 
the numbers to the outside of the drive. Then continue with the following commands: 

# mt rew (rewind the magnetic tape) 

# mount /dev/${name} /usr (mount the usr filesystem) 

# cd /usr (make /usr the current directory) 

# mkdir sys (make directory for system source) 

If your system disk is an RK07, be sure your second pack is loaded onto the second 
drive (drive 1), and spinning, and the READY light is lit. Then type: 

# newfs hk1a rk07 

newfs prints all the filesystem partitions for /usr /sys. Save these numbers as you did 
above. Then type: 

# mount /dev/hkla /usr/ sys 

Continue with the following commands for all system disks, including RK07s: 

# cd sys (make /usr/sys the current directory) 

# mt fsf 3 (wind the magnetic tape forward three 

files) 

# tar xpbf 20 /dev/rmt12 (extract the system source) 

(this takes about 5-10 minutes) 

# cd .. (make /usr the current directory) 

# mt fsf 

# tar xpbf 20 /dev/rmt12 (extract all of usr except /usr/src) 

(this takes about 15-20 minutes) 
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# cd / (make / (root) the current directory) 

# chmod 755 /usr/sys 

If your system disks are RK07s, type: 

# umount /dev/hk1a 

Continue with the following for all system disks, including RK07s: 

# umount /dev/${name} 

Check the consistency of the / usr filesystem by typing: 

# fsck /dev/r${name} 

The output from fsck should look similar to: 

** /dev/mcOh 

** Last Mounted on /usr 

* * Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

* * Phase 4 - Check Reference Counts 

* * Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 

If your system disks are RK07s, check the consistency of the /usr/sys file on drive 1 
by typing: 

# fsck , dev/rhk1a 

The output from fsck should look similar to: 

111!!® 

** Last Mounted on /usr/sys 

* * Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 

* * Phase 3 - Check Connectivity 

• * Phase 4 - Check Reference Counts 

* * Phase 5 - Check Cyl groups 

864 files, 3745 used, 3678 free (134 frags, 433 blocks) 

If there are inconsistencies in the filesystems, the system may prompt you for correc- 
tive action. See fsck — the UNIX Filesystem Check Program for further information. 
If serious problems exist, try the extractions again, starting with the newfs ${name} 
${type} command above. 
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Now remount the /usr filesystem by typing: 

# /etc/mount /dev/$name /usr 

If your system disks are RK07s, you also need to remount the /usr/sys filesystem. To 

jljjll^ 

# /etc /mount /dev/hk1a /usr/sys 

You have now extracted all the data on the first distribution tape. Unload the first 
tape from the tape drive, and store it in a safe place. You will be extracting the files 
from the second distribution tape later in subsection 4.5. 

The ULTRIX-32 operating system is installed and running in single-user mode. See 
section 3 (System Setup) for information on how to further set up your system. 
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2.4. Bootstrap Procedure for All VAXes from RA60 Distribution 



Subsection 2.4 explains the bootstrap procedure for installing the ULTRIX-32 
software on the VAX-11/730, VAX-11/750, and VAX-11/780 processors from the dis- 
tribution RA60 disk. 

This procedure should take about half an hour to complete. 
Getting Started 

Before starting the bootstrap procedure, you must be familiar with your system 
configuration. If your system is under a Digital Service Contract, then you can obtain 
detailed configuration information from the Configuration Worksheet section of the 
Site Management Guide. 

If your processor is a VAX-11/750 you need a UDA Boot ROM. However, this docu- 
ment explains how to bootstrap a system without the ROM. 

You will need the following equipment: 

• One ULTRIX-32 distribution RA60 disk 

• One ULTRIX-32 distribution cassette (for VAX-11/730, and VAX-11/750 systems 
without the UDA Boot ROM) 

• One ULTRIX-32 distribution floppy diskette (for VAX-11/780 systems, only) 

• One blank floppy diskette (for VAX-11/780 systems) 

• One blank cassette (for VAX-11/730 systems) 

• One formatted RA60 disk pack (to make the backup copy of the distribution) 

• A VAX system 

Follow these steps to prepare your system for booting from the RA60: 

1) Load the Distribution RA60 Disk Pack 

Load the distribution disk pack into disk drive 0. Be sure the RA60 disk pack is 
spinning and that the READY light is lit. 

2) Select the destination disk drive 

If the destination disk drive you select is not drive UNIT 1, change the unit plug 
so it becomes UNIT 1. 

3) Insert the Distribution Cassette or Floppy Diskette 

If you have either a VAX-11/750 without the UDA ROM or a VAX-11/730 proces- 
sor, insert the distribution cassette into the console TU58 disk drive on the front of 
the processor (drive 0). (Note that the cassette label faces up.) 

If you have a VAX-11/780, insert the distribution floppy diskette into the console 



48 ULTRIX-32 Installation Guide 



floppy diskette drive inside the processor (drive 0). (Note that the floppy diskette 
label points toward the handle of the diskette drive.) 

4) Prepare the CPU 

If your CPU is a VAX-1 1/730, set the re-start switch to OFF and the rotary key 
switch to LOCAL. 

If your CPU is a VAX- 11/750, set the power-on action switch to HALT and the 
rotary key switch to LOCAL. It makes no difference how the boot device switch is 
set during the installation. 

If your CPU is a VAX- 11/780, set the auto re-start switch to OFF and the rotary 
key switch to LOCAL. It makes no difference how the boot device switch is set 
during the installation. 

5) Prepare the DECwriter III (LA120) 

If you have a DECwriter III (LA120), you must set up your console terminal before 
proceeding with the installation. 

To set up the console, hold down <SETUP> and press D simultaneously until the 
LED display on the console (at the upper left-hand corner of the keys) is 0 (zero). 

2.4.1. Boot the Root Filesystem 

The system must be halted; if it is not, type: 

A P 

»>H 

The console subsystem prompts with »>. If you make a typing mistake, type 
<DELETE> to erase a character, <CTRL/U> to erase the line, or <CTRL/C> to 
interrupt the process. 

The first step is to load the bootstrap program and boot the ULTRIX-32 root system. 
To do this, type the following command sequence which pertains to your system: 



a) VAX- 11/730 



»>S 2 
Boot 



>»l 

»>L DD0:BOOT 



(initialize the processor) 
(boot the cassette) 
(this takes about one minute) 
(start the boot program) 



: ra(0,0)vmunix 



(boot the ULTRIX-32 kernel off the root) 
(this takes about one minute) 
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b) VAX- 11/750 

VAX-11/750 With a UDA Boot ROM: 



»>l 



■B/3 DUAO 



(initialize the processor) 



VAX-11/750 Without a UDA Boot ROM: 
»>l 

»>B DDAO 



%% 
= boot 



(initialize the processor) 
(boot the cassette) 

(this takes about 60 seconds) 



(start the boot program) 
(this takes about one minute) 



Both VAX-ll/750s: 

Type the following for VAX-11/750 systems with and without the UDA Boot ROM: 
Boot 

: ra(0,0)vmunix (boot the ULTRIX-32 kernel off the root) 



c) VAX- 11/780 




(unjam the SBI) 
(initialize the processor) 
(boot the floppy diskette) 



CPU HALTED 
INIT SEQ DONE 

LOAD DONE, xxxxxxxx BYTES LOADED 
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Boot 

: ra(0,0)vmunix (boot the ULTRIX-32 kernel off the root) 

(this takes about one minute) 



All VAXes 

The standalone boot program (for all VAXes) then reads the ULTRIX-32 kernel from 
the root filesystem. The system starts, displaying the following messages: 



Updating 11/750 micro code... 

215564+64088+69764 start 0xf98 
ULTRIX-32 (date and time) 
real mem = xxxxxx 
avail mem = yyy 



(appears if you are running 
revision 5 or greater on 
VAX-11/750S only) 
(these numbers are approximate) 

(this takes a minute) 



information about available devices 



root device? raO 
erase kill *U, intr "C 
# 



2.4.1.1. Explanation of System Boot Messages 

The first three numbers printed by the bootstrap programs are the sizes of different 
parts of the system (text, initialized and uninitialized data). 
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The ULTRIX-32 system then runs for the first time, beginning with a banner identi- 
fying the release and version of the system that is in use and the date it was compiled. 

The mem messages give the amount of real (physical) memory and the memory avail- 
able to user programs in bytes. For example, if your machine has 4mb of memory, 
then xxxxxx will be 4190208, 4096 bytes less than 4mb. The system reserves the last 
4096 bytes of memory for use in logging system messages and does not count it as part 
of real memory. Available memory is the amount of physical memory left over for 
user processes after the ULTRIX-32 software has been loaded. 

Information about the system is shown next, followed by messages showing what dev- 
ices were found on the current processor. These messages are described in auto- 
conf (4). The distributed system may not have found all the communications devices 
(dmfs and dzs), or mass storage peripherals you have if you have more than two of one 
device. This is corrected later when you create a description of your machine from 
which to configure the ULTRIX-32 system. These messages contain much of the 
information that will be used in creating the configuration. In a correctly configured 
system most of the information present in the configuration description is printed out 
at boot time as the system verifies that each device is present. 

If the system does not reboot properly, see Appendix C for help with troubleshooting. 

The ULTRIX-32 system is running in single-user mode. The # prompt is from the 
ULTRIX-32 operating system, and tells you that you are the superuser. 

2.4.2. Set the Date and the Root Password 

First, set the date and time: 

# date yymmddhhmm 
Where: 

yy equals the last two digits of the year 

mm equals the number of the month of the year 

dd equals the number of the day of the month 

hh equals the hour of the day (based on 24 hours) 

mm equals the minutes of the hour 

Next, set the superuser password. The password you select must contain at least six 
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characters: 

# passwd root (set password for superuser) 
New password: (password will not echo) 
Retype new password: 

# 

2.4.3. Backup the Distribution Medium 

In this step you will copy your RA60 distribution onto another disk (RA60, RA80, or 
RA81). The newly copied disk will become your system disk, and the original distri- 
bution pack will be stored in a safe place for backup purposes. 

To make the copy, follow the directions below. 

If the destination drive you chose is an RA60, load it into drive 1 (see Getting 
Started). 

Be sure the destination disk is spinning and the READY light is lit. 

Find your destination drive from the list below and use the corresponding value for zz 
in the newfs command: 

zz Destination Drive 
60 RA60 

80 RA80 

81 RA81 

Issue the newfs command: 

# newfs rala razz 

For example, if your destination drive were an RA81 you would type: 

# newfs rala ra81 

Now copy the RA60 distribution using the dump (8) and restore (8) commands to copy 
the / and / usr partitions as follows. 

First copy the / partition from the RA60 distribution onto the corresponding partition 
of your destination pack on drive 1: 

# sync 

# /etc /mount /dev/ra1a /mnt (specify the destination partition) 

# dump Of - /dev/raOa I (cd /mnt; restore rf -) 

(raOa is the source partition) 

# sync 

# /etc/umount /dev/ra1a (unmount the destination partition) 

# fsck /dev/rra1a (fsck the destination raw device) 

# sync 
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Now copy the /usr partition. First issue the newfs command: 

# newfs ralh razz (zz has the same value as above) 

Now repeat the commands above altering the dump and restore commands to reflect 
the partition: 

# sync 

# /etc/mount /dev/ra1h /mnt (specify the destination partition) 

# dump Of - /dev/raOg I (cd /mnt; restore rf -) 

(raOh is the source partition) 

# sync 

# /etc/umount /dev/ra1h (unmount the destination partition) 

# fsck /dev/rra1h (fsck the destination raw device) 

# sync 

# halt 

Spin down and unload the original distribution pack in drive 1. Store the distribution 
pack in a safe place for backup purposes. 

Make sure the unit number of the disk (drive) you just copied is 0. If it is not UNIT 
0, swap the unit plug with that of drive UNIT 0. 

Now reboot the system to single-user mode on the new disk (drive 0) using the steps 
in subsection 2.4.1. 

Your system should be running off the newly copied pack. 
2.4.4. Update the Console Cassette or Floppy Diskette 

If you have a VAX-11/730 or a VAX-11/780 you need to update the console cassette 
or console floppy diskette. 

To prepare the system type: 

# /etc/mount /dev/raOh /usr 

2.4.4.1. Update the Console Cassette 

If you have a VAX-11/730 system, you need to build the boot cassette. You do this by 
copying some files from the local console cassette (that is, the cassette that came with 
your hardware), adding some files from the ULTRIX-32 system, and writing them all 
to a blank cassette. 

This new boot cassette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First, remove the distribution cassette from the external TU58 drive (drive 0) and 
insert a blank cassette. Be sure the blank cassette is NOT write protected (the record 
tab should be in the left-most position). 
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Make sure the local console cassette is loaded in the internal TU58 drive (drive 1). To 
locate this drive, pull out the front of the CPU like a desk drawer, and you will find 
drive 1 on the back right-hand side. 

Then, change into the directory where the console cassette information is stored: 

# cd /sys/ cassette 

Next set up the default boot device. If you are using an IDC R80 as your primary 
root type: 

# cp defboo.rb defboo.cmd 

If you are using a drive on a UDA50 as your primary root type: 

# cp defboo.ra defboo.cmd 

To build the updated boot cassette, type: 

# make update 



(this takes about 25 minutes) 



lists all of the files on the cassette 



Console cassette update complete. 

The new cassette should be installed in the internal 

tu58 slot (Drive 1). 

# 

# 

Store the distribution cassette and the local console cassette in a safe place. The local 
console cassette is required to boot VAX/VMS systems. Remove the boot cassette you 
just built from the external drive and insert it in the internal TU58 cassette drive 
(drive 1). 

At this point, you can make more copies of the new boot cassette by using the flcopy 
maintenance command (see arff(8V)). 

The system is now bootstrapped, and running on your system disk in single-user 
mode. Be sure to store the original RL02 distribution disks in a safe place. 

See section 3 (System Setup) for information on how to further set up your system. 
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2.4.4.2. Update the Console Floppy Diskette 

If you have a VAX-11/780 you will need to build the boot floppy diskette. You do 
this by copying some files from the console floppy diskette, adding some files from the 
ULTRIX-32 system, and writing them all to a blank diskette. 

The boot floppy diskette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First remove the distribution diskette from the drive and store it in a safe place. 
Insert the VAX-11/780 console floppy diskette. 

Then change into the directory where the console floppy diskette information is stored 
by typing: 

# cd /sys/floppy 

Then set up the default boot device. If you are using a drive on a UDA50 (for exam- 
ple, an RA81) as your primary root type: 

# cp defboo.ra defboo.cmd 
Otherwise type: 

# cp defboo.hp defboo.cmd 

NOTE: If the local configuration requires any changes in restar.cmd or defboo.cmd 
(for example, for interleaved memory controllers), these should be made now. 

Type the following command to build the updated boot floppy diskette: 

# make update 

lists all the files on the hardware floppy diskette 
Change Floppy, Hit return when done. 



Remove the VAX-11/780 console floppy diskette, insert a blank (scratch) diskette, and 
press the <RETURN> key. To complete the procedure, respond with yes to the 
system's next question. 
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Are you sure you want to clobber the floppy? yes 



lists all the files on the new boot floppy diskette 



# 

You can make more copies of the boot floppy diskette by using the flcopy maintenance 
command (see arff(8V). 

Your ULTRIX-32 system is now fully bootstrapped. See section 3 (System Setup) for 
information on how to further set up your system. 
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5. Bootstrap Procedure for All VAXes from RK07 Distribution 



lbsection 2.5 explains the bootstrap procedure for installing the ULTRIX-32 
ftware on the VAX-1 1/730, VAX-11/750, and VAX-11/780 processors from the dis- 
ibution RK07 disks. 

his procedure should take about five hours to complete, 
etting Started 

3fore starting the bootstrap procedure, you must be familiar with your system 
nfiguration. If your system is under a Digital Service Contract, then you can obtain 
(tailed configuration information from the Configuration Worksheet section of the 
te Management Guide. 

your processor is a VAX-11/750 you need an RK Boot ROM. 

du will need the following equipment: 
Three ULTRIX-32 distribution RK07 disks 

One ULTRIX-32 distribution cassette (for VAX-1 1/730 and fVAX-11/750 systems) 
One ULTRIX-32 distribution floppy diskette (for VAX-11/780 systems, only) 
One blank cassette (for VAX-11/730 systems) 
One blank floppy diskette (for VAX-11/780 systems) 

Three formatted RK07 disk packs (to make a backup copy of the distribution) 
A VAX system 

>llow these steps to prepare your system for booting from the RK07s: 
Load the First Distribution & Scratch RK07 Disk Packs 

Load the distribution disk pack labeled ROOT in disk drive 0, and load a scratch 
disk pack in disk drive 1. Be sure the disk packs are spinning and that the 
READY lights are lit. 

Insert the Distribution Cassette or Floppy Diskette 

If you have a VAX-11/730 or VAX-11/750 processor, insert the distribution 
cassette into the console TU58 disk drive on the front of the processor (drive 0). 
(Note that the cassette label faces up.) Be sure the cassette is write protected (the 
record tab is in the right-most position). 

If you have a VAX-11/780, insert the distribution floppy diskette into the console 
floppy diskette drive inside the processor (drive 0). (Note that the floppy diskette 
label points toward the handle of the diskette drive.) 
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3) Prepare the CPU 

If your CPU is a VAX-1 1/730, set the restart switch to OFF and the rotary key 
switch to LOCAL. 

If your CPU is a VAX- 11/750, set the power-on action switch to HALT and the 
rotary key switch to LOCAL. It makes no difference how the boot device switch is 
set during the installation. 

If your CPU is a VAX- 11/780, set the auto re-start switch to OFF and the rotary 
key switch to LOCAL. It makes no difference how the boot device switch is set 
during the installation. 

4) Prepare the DECwriter III (LA120) 

If you have a DECwriter III (LA120), you must set up your console terminal before 
proceeding with the installation. 

To set up the console, hold down <SETUP> and press D simultaneously until the 
LED display on the console (at the upper left-hand corner of the keys) is 0 (zero). 

2.5.1. Boot the Root Filesystem 

The system must be halted; if it is not, type: 

>»H 

The console subsystem prompts with »>. If you make a typing mistake, type 
<DELETE> to erase a character, <CTRL/U> to erase the line, or <CTRL/C> to 
interrupt the process. 

The first step is to load the bootstrap program and boot the ULTRIX-32 root system. 
To do this, type the following command sequence that pertains to your system: 



a) VAX- 11/730 



»>S 2 



»>l 

>»L DD0:BOOT 



(initialize the processor) 
(boot the cassette) 
(this takes about one minute) 
(start the boot program) 



Boot 



: hk(0,0)vmunix 



(boot the ULTRIX-32 kernel off 
the root) 



b) VAX- 11/750 



»>l 

»>B/3 DMAO 
%% 
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(initialize the processor) 



Boot 

: hk(0,0)vmunix 



(boot the ULTRIX-32 kernel off 
the root) 



c) VAX- 11/780 

»>U 
»>B ANY 



(unjam the SBI) 
(initialize the processor) 
(boot the floppy diskette) 



CPU HALTED 
INIT SEQ DONE 

LOAD DONE, xxxxxxxx BYTES LOADED 



Boot 

: hk(0,0)vmimix (boot the ULTRIX-32 kernel off 

the root) 



All VAXes 

The standalone boot program (for all VAXes) then reads the ULTRIX-32 kernel from 
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the root filesystem. The system starts, displaying the following messages: 



Updating 11/750 micro code... 

215564+64088+69764 start 0xf98 
ULTRIX-32 (date and time) 
real mem = xxxxxx 
avail mem = yyy 



(appears if you are running on 

a revision 5 or greater 

VAX-1 1/750 system) 

(these numbers are approximate) 

(this takes about five minutes) 



information about available devices 



root device? hkO (an RK07 on drive 0) 

erase A ?, kill A U, intr "C 

# 



2.5.1.1. Explanation of System Boot Messages 

The first three numbers printed by the bootstrap programs are the sizes of different 
parts of the system (text, initialized and uninitialized data). 

The ULTRIX-32 system then runs for the first time, beginning with a banner identi- 
fying the release and version of the system that is in use and the date it was compiled. 

The mem messages give the amount of real (physical) memory and the memory avail- 
able to user programs in bytes. For example, if your machine has 4mb of memory, 
then xxxxxx will be 4190208, 4096 bytes less than 4mb. The system reserves the last 
4096 bytes of memory for use in logging system messages and does not count it as part 
of real memory. Available memory is the amount of physical memory left over for 
user processes after the ULTRIX-32 software has been loaded. 

Information about the system is shown next, followed by messages showing what dev- 
ices were found on the current processor. These messages are described in auto- 
conf (4). The distributed system may not have found all the communications devices 
(dmfs and dzs), or mass storage peripherals you have if you have more than two of one 
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device. This is corrected later when you create a description of your machine from 
which to configure the ULTRIX-32 system. These messages contain much of the 
information that will be used in creating the configuration. In a correctly configured 
system most of the information present in the configuration description is printed out 
at boot time as the system verifies that each device is present. 

If the system does not reboot properly, see Appendix C for help with troubleshooting. 

The ULTRIX-32 system is running in single-user mode. The # prompt is from the 
ULTRIX-32 operating system, and tells you that you are the superuser. 

2.5.2. Set the Date and the Root Password 

First, set the date and time: 

# date yymmddhhmm 
Where: 

yy equals the last two digits of the year 

mm equals the number of the month of the year 

dd equals the number of the day of the month 

hh equals the hour of the day (based on 24 hours) 

mm equals the minutes of the hour 

Next, set the superuser password. The password you select must contain at least six 
characters: 

# passwd root (set password for superuser) 
New password: (password will not echo) 
Retype new password: 

# 

2.5.3. Backup the Distribution Media 

You should make a backup copy of your RK07 distribution. To do this, you will need 
three scratch RK07 disk packs. 

You will use the dump (8) and restore (8) commands to make the backup copy of the 
distribution disk packs. 

Follow the instructions in the next three subsections to make a backup copy of the 
distribution disk packs. 

2.5.3.1. The First Distribution Pack (ROOT) 

Be sure the ROOT distribution pack is in drive 0, the first scratch pack is in drive 1, 
and both disks are spinning and the READY lights are on. 
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Type the following to copy root and /usr (the a and g partitions): 

# update 

# newfs rhkla rk07 (specify the destination partition. Save 

the numbers newfs generates) 
Warning: inode blocks/cyl group (12) >= data blocks (2) in last 



10656, 11744, 12704, 13792, 14880, 

# sync 

# /etc/mount /dev/hk1a /mnt (specify the destination partition) 

# dump Of - /dev/hkOa I (cd /mnt; restore rf -) 

(hkOa is the source partition) 
(the entire dump takes about 5 minutes) 
DUMP: Date of this level 0 dump: xxx xxx xx xx:xx:xx xxxx 



Warning: ./lost+found: File exists 
[NIL] ./tmp/rstdir450741748: inconsistent state 
abort? [yn] n (type n) 

[NIL] ./tmp/rstmode450741748: inconsistent state 
abort? [yn] n (type n) 

DUMP: 50.78% done, finished in 0:04 
DUMP: DUMP: 3958 tape blocks on 1 tape(s) 
DUMP: DUMP IS DONE 

# sync 

# /etc/umount /dev/hkla (unmount the destination partition) 

# fsck /dev/rhkla (fsck the destination raw device) 
** /dev/rhkla 

** last Mounted on /rnnt 



350 files, 3631 used, 3792 free (56 frags, 467 blocks) 

# sync 

# newfs rhklg rk07 (specify the destination partition. Save 

the numbers newfs generates) 
/dev/rhklg: 27786 sectors in 421 cylinders of 3 tracks, 22 sectors 



21152, 22232, 23312, 24392, 25376, 26456, 27536, 
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# sync 

# /etc/mount /dev/hklg /mnt (specify the destination partition) 

# dump Of - /dev/hkOg I (cd /mnt; restore rf -) 

(hkOg is the source partition. The 
entire dump takes about 15 minutes) 
DUMP: Date of this level 0 dump: xxx xxx xx xx:xx:xx xxxx 



Warning: ./lost+found: File exits 
DUMP: 53.37% done, finished in 0:04 
DUMP: 99.68% done, finished on 0:00 
DUMP: DUMP: 10286 tape blocks on 1 tape(s) 
DUMP: DUMP IS DONE 

# sync 

# /etc/umount /dev/hklg (unmount the destination partition) 

# fsck /dev/rhklg (fsck the destination raw device) 
** /dev/rhklg 

803 files, 18878 used, 7363 free (107 frags, 907 blocks) 

# sync 

# halt 

syncing disks... done 
halting (in tight loop): hit 

T (type <CTRL/P>) 

HALT T (type H) 

xx xxxxx (program counter) 

»>H 

NOTE: Do not be concerned with the warnings sited above. Do remember to save the 
numbers that newfs generates; they may prove helpful in an emergency. 

Now spin down and unload the distribution disk pack in drive 0 and the scratch disk 
pack in drive 1. Label the scratch pack ROOT. 

2.5.3.2. The Second Distribution Pack (USERS) 

Load the distribution pack labeled USERS into drive 0. Load the second scratch pack 
into drive 1. 

When both drives are spinning and the READY lights are lit, reboot the system off of 
drive 0 using the directions described in subsection 2.5.1. 
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After the system has been rebooted, type the following to copy root (the a partition): 

# update 

# newfs rhkla rk07 (specify the destination partition. Save 

the numbers newfs generates) 
Warning: inode blocks/cyl group (12) >= data blocks (2) in last 



10656, 11744, 12704, 13792, 14880, 

# sync 

# /etc/mount /dev/hk1a /mnt (specify the destination partition) 

# dump Of - /dev/hkOa I (cd /mnt; restore rf -) 

(hkOa is the source partition. The 
entire dump takes about 15 minutes) 
DUMP: Date of this level 0 dump: xxx xxx xx xx:xx:xx xxxx 



Warning: ./lost+found: File exists 
[NIL] ./tmp/rstdir450741748: inconsistent state 
abort? [yn] n (type n) 

[NIL] ./tmp/rstmode450741748: inconsistent state 
abort? [yn] n (type n) 

DUMP: 50.78% done, finished in 0:04 
DUMP: DUMP: 3958 tape blocks on 1 tape(s) 
DUMP: DUMP IS DONE 

# sync 

# /etc/umount /dev/hkla (unmount the destination partition) 

# fsck /dev/rhkla (fsck the destination raw device) 
** /dev/rhkla 

** last Mounted on /mnt 



966 files, 5529 used, 1894 free (102 frags, 224 blocks) 

# sync 

# halt 

# halt 

syncing disks... done 

halting (in tight loop); hit 

T (type <CTRL/P>) 

HALT A P (type H) 

xx xxxxx (program counter) 
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»> H 

NOTE: Do not be concerned with the warnings sited above. Do remember to save the 
numbers that newfs generates; they may prove invaluable in an emergency. 

Now spin down and unload the distribution disk pack in drive 0 and the scratch disk 
pack in drive 1. Label the scratch pack USERS. 

2.5.3.3. The Third Distribution Pack (ADDITIONAL SOFTWARE) 

Load the distribution pack labeled ADDITIONAL SOFTWARE into drive 0, and load the 
third scratch pack into drive 1. 

When both disks are spinning and the READY lights are on, reboot the system off of 
drive 0 using the directions described in subsection 2.5.1. 

After the system has been rebooted, type the following to copy root and /usr (the a 
and g partitions): 

# update 

# newfs rhkla rk07 (specify the destination partition. Save 

the numbers newfs generates) 
Warning: inode blocks/cyl group (12) >= data blocks (2) in last 



10656, 11744, 12704, 13792, 14880, 

# sync 

# /etc/mount /dev/hk1a /mnt (specify the destination partition) 

# dump Of - /dev/hkOa I (cd /mnt; restore rf -) 

(hkOa is the source partition. The 
entire dump takes about 5 minutes) 
DUMP: Date of this level 0 dump: xxx xxx xx xx:xx:xx xxxx 



Warning: ./lost+found: File exists 
[NIL] ./tmp/rstdir450741748: inconsistent state 
abort? [yn] n (type n) 

[NIL] ./tmp/rstmode450741748: inconsistent state 
abort? [yn] n (type n) 

DUMP: 50.78% done, finished in 0:04 
DUMP: DUMP: 2028 tape blocks on 1 tape(s) 
DUMP: DUMP IS DONE 



# sync 

# /etc/umount /dev/hkla 

# fsck /dev/rhkla 



(unmount the destination partition) 
(fsck the destination raw device) 
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** /dev/rhkla 

** last Mounted on /mnt 



350 files, 3631 used, 3792 free (56 frags, 467 blocks) 

# sync 

# dd if=/dev/rhkOg of=/dev/rhklg bs=10b 
#halt 

syncing disks... done 
halting (in tight loop): hit 

A P (type <CTRL/P>) 

HALT A P (type H) 

xx xxxxx (program counter) 

»>H 

NOTE: Do not be concerned with the warnings and diagnostics sited above. Do 
remember to save the numbers that newfs generates; they may prove invaluable in an 
emergency. 

Now spin down and unload the distribution disk pack in drive 0 and the scratch disk 
pack in drive 1. Label the scratch pack ADDITIONAL SOFTWARE. 

Load the backup copy labeled ROOT into drive 0, and load the backup copy labeled 
USERS into drive 1. 

If you have a third RK07 drive, load the backup copy labeled ADDITIONAL SOFTWARE 
into drive 2. 

When all the drives are spinning and the READY lights are on, reboot the system off 
of drive 0 using the directions described in subsection 2.5.1. 

The backup is now complete. From now on you should run your system off of the 
backup copies. Store the distribution disk packs in a safe place. 

If your system is a VAX- 11/750, proceed to section 3 (System Setup) for information 
on how to further set up your system. Otherwise continue with the subsection below. 

2.5.4. Update the Console Cassette or Floppy Diskette 

If you have a VAX-11/730 or a VAX-11/780 you need to update the console cassette 
or console floppy diskette. 

Be sure the backup pack labeled ROOT is in drive 0, and the backup pack labeled 
USERS is in drive 1. Both packs should be spinning, with the READY lights lit. 
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Type the following: 

# /etc/mount /dev/hkOg /usr 

# /etc/mount /dev/hk1a/usr/sys 

# rm /sys 

# In -s /usr/sys/sys /sys 

You are now ready to build the boot cassette or floppy diskette. 

2.5.4.1. Update the Console Cassette 

If you have a VAX-1 1/730 system, you need to build the boot cassette. You do this by 
copying some files from the local console cassette (that is, the cassette that came with 
your hardware), adding some files from the ULTRIX-32 system, and writing them all 
to a blank cassette. 

This new boot cassette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First, remove the distribution cassette from the external TU58 drive (drive 0) and 
insert a blank cassette. Be sure the blank cassette is NOT write protected (the record 
tab should be in the left-most position). 

Make sure the local console cassette is loaded in the internal TU58 drive (drive 1). To 
locate this drive, pull out the front of the CPU like a desk drawer, and you will find 
drive 1 on the back right-hand side. 

Then, change into the directory where the console cassette information is stored and 
set up the default boot device: 

# cd /sys /cassette 

# cp defboo.hk defboo.cmd 

To build the updated boot cassette, type: 

# make update 



(this takes about 25 minutes) 



lists all of the files on the cassette 



Console cassette update complete. 
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The new cassette should be installed in the internal 
tu58 slot (Drive 1). 

# sync 

# newfs rhklg rk07 

# sync 
# 

Store the distribution cassette and the local console cassette in a safe place. The ori- 
ginal local console cassette is required to boot VAX/VMS systems. Remove the boot 
cassette you just built from the external drive and insert it in the internal TU58 
cassette drive (drive 1). 

At this point, you can make more copies of the new boot cassette by using the flcopy 
maintenance command (see arff(8V)). 

The system is now bootstrapped, and running on your system disk in single-user 
mode. Be sure to store the original RL02 distribution disks in a safe place. 

See section 3 (System Setup) for information on how to further set up your system. 
2.5.4.2. Update the Console Floppy Diskette 

If you have a VAX-11/780 you need to build the boot floppy diskette. You do this by 
copying some files from the console floppy diskette, adding some files from the 
ULTRIX-32 system, and writing them all to a blank diskette. 

The boot floppy diskette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First remove the distribution diskette from the drive and store it in a safe place. 
Insert the VAX-11/780 console floppy diskette. 

Then change into the directory where the console floppy diskette information is stored 
and set up the default boot device: 

# cd /sys/ floppy 

# cp defboo.hk defboo.cmd 

NOTE: If the local configuration requires any changes in restar.cmd or defboo.cmd 
(for example, for interleaved memory controllers), these should be made now. 

Type the following command to build the updated boot floppy diskette: 
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# make update 



lists all the files on the hardware floppy diskette 



Change Floppy, Hit return when done. 

Remove the VAX- 11/780 console floppy diskette, insert a blank (scratch) diskette, and 
press the <RETURN> key. To complete the procedure, respond with yes to the 
system's next question. 



Are you sure you want to clobber the floppy? yes 



lists all the files on the new boot floppy diskette 



# sync 

# newfs rhklg rk07 

# sync 

You can make more copies of the boot floppy diskette by using the flcopy maintenance 
command (see arff(8V). 

Your system is now bootstrapped and running in single-user mode. You will be boot- 
ing the ADDITIONAL SOFTWARE backup disk later in subsection 5.5. 

See section 3 (System Setup) for information on how to further set up your system. 
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2.6. Bootstrap Procedure for VAX- 11/730 & VAX- 11/750 from RL02 



Subsection 2.6 explains the bootstrap procedure for installing the ULTRIX-32 
software on the VAX- 11/730 and VAX- 11/750 processors from the distribution RL02 
disk. 

This procedure should take about one and one half hours to complete. 
Getting Started 

Before starting the bootstrap procedure, you must be familiar with your system 
configuration. If your system is under a Digital Service Contract, then you can obtain 
detailed configuration information from the Configuration Worksheet section of the 
Site Management Guide. 

If your processor is a VAX- 11/750 you should have an RL Boot ROM. However, this 
document explains how to bootstrap a system without the ROM. 

You will need the following equipment: 

• Four ULTRIX-32 distribution RL02 disks 

• One ULTRIX-32 distribution cassette (for VAX-ll/730's, and VAX-11/750 systems 
without the RL ROM) 

• One blank cassette (for VAX- 11/730 systems) 

• A VAX-11/730 or VAX-11/750 system 

Follow these steps to prepare your system for booting from the RL02: 

1) Load the RL02 Miniroot Disk Pack 

On a VAX-11/730, load the distribution disk pack labeled ROOT into disk drive 1. 
On a VAX-11/750, load the distribution disk pack labeled ROOT into disk drive 0. 

Be sure the RL02 disk pack is spinning and that the READY light is lit. 

2) Insert the Distribution Cassette 

If you have either a VAX-11/750 without the RL ROM or a VAX-11/730 processor, 
insert the distribution cassette into the console TU58 disk drive on the front of the 
processor (drive 0). (Note that the cassette label faces up.) 

3) Prepare the CPU 

If your CPU is a VAX-11/730, set the re-start switch to OFF and the rotary key 
switch to LOCAL. 

If your CPU is a VAX-11/750, set the power-on action switch to HALT and the 
rotary key switch to LOCAL. It makes no difference how the boot device switch is 
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set during the installation. 
4) Prepare the DECwriter III (LA120) 

If you have a DECwriter III (LA120), you must set up your console terminal before 
proceeding with the installation. 

To set up the console, hold down <SETUP> and press D simultaneously until the 
LED display on the console (at the upper left-hand corner of the keys) is 0 (zero). 

General Steps 

The RL02 bootstrap procedure to create a working system consists of the following 
general steps: 

1) Boot the Distributed Root Filesystem 

2) Copy the RL02 Distributed Root to the System Disk 

3) Set up and Install the /usr Filesystem 

4) Update the Console Cassette (VAX- 11/730 systems, only) 

The next few subsections describe these stdps in detail. References to disk drives are 
of the form xx (n,m), where xx is one of the nam£§4n Table 2.6.1 

Table 2.6.1 ULTRIX Disk Names and^ieir Systems 



Disk 


XX 


System 


RA80 


ra 


VAX-11/730 & VAX-11/750 


RA81 


ra 


VAX-11/730 & VAX-11/750 


RL02 (IDC) 


rb 


VAX-11/730 


RL02 


rl 


VAX-11/750 


RM03 


hp 


VAX-11/750 


RM05 


hp 


VAX-11/750 


RM80 


hp 


VAX-11/750 


RP06 


hp 


VAX-11/750 


R80(IDC) 


rb 


VAX-11/730 



n is equal to the unit number of the disk drive you are booting off of. If your system 
is a VAX-11/730, and you are booting off of the distribution RL02, n is 1. If you are 
booting off any other disk, n is always 0. If your system is a VAX-11/750, n is always 
0. 

m is always specified in the command lines of this document. It is the partition (in 
the range 0-7). 
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2.6.1. Boot the Distributed Root Filesystem 

The system must be halted; if it is not, type: 

»>H 

The console subsystem prompts with »>. If you make a typing mistake, type 
<DELETE> to erase a character, <CTRL/U> to erase the line, or <CTRL/C> to 
interrupt the process. 

The first step is to load the bootstrap program and boot the ULTRIX-32 root system. 
To do this, type the following command sequence which pertains to your system: 

a) VAX- 11/730 

(initialize the processor) 
(boot the cassette) 
(this takes about one minute) 
(start the boot program) 



: xx(rc,0)vmunix (boot the ULTRIX-32 kernel off the 

root; this takes about five minutes) 
(for the first boot, xx is rb and n is 1) 



L DD0:BOOT 



»>S 2 
Boot 



b) VAX-11/750 

VAX-11/750 With an RL Boot ROM: 
»>l 

»>B/3 DLAO 

%% 



(initialize the processor) 



VAX-11/750 Without an RL Boot ROM: 
»>l 

»>B DDAO 



%% 
= boot 



(initialize the processor) 
(boot the cassette) 

(this takes about one minute) 



(start the boot program) 
(this takes about one minute) 
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Both VAX-ll/750s 

Type the following for VAX- 11/750 systems with and without the RL Boot ROM: 
Boot 

: xx(0,0)vmunix (boot the ULTRIX-32 kernel off the 

root; this takes about five minutes) 
(for the first boot, xx is rl) 



All VAX Systems 

The standalone boot program (for VAX- 11/730 and VAX- 11/750 systems) then reads 
the ULTRIX-32 kernel from the root filesystem. The system starts, displaying the 
following messages: 



Updating 11/750 micro code... 



215564+64088+69764 start 0xf98 
ULTRIX-32 (date and time) 
real mem = xxxxxx 
avail mem = yyy 



(appears if you are running 
revision 5 or greater on 
VAX-1 1 / 750 systems only) 
(these numbers are approximate) 

(this takes about five minutes) 



information about available devices 



root device? 



erase A ?, kill U, intr "C 
# 



(xxn is rbl on a 730, 

and rlO on a 750 for the first 

boot) 
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2.6.1.1. Explanation of System Boot Messages 

The first three numbers printed by the bootstrap programs are the sizes of different 
parts of the system (text, initialized and uninitialized data). 

The ULTRIX-32 system then runs for the first time, beginning with a banner identi- 
fying the release and version of the system that is in use and the date it was compiled. 

The mem messages give the amount of real (physical) memory and the memory avail- 
able to user programs in bytes. For example, if your machine has 4mb of memory, 
then xxxxxx will be 4190208, 4096 bytes less than 4mb. The system reserves the last 
4096 bytes of memory for use in logging system messages and does not count it as part 
of real memory. Available memory is the amount of physical memory left over for 
user processes after the ULTRIX-32 software has been loaded. 

Information about the system is shown next, followed by messages showing what dev- 
ices were found on the current processor. These messages are described in auto- 
conf (4). The distributed system may not have found all the communications devices 
(dmfs and dzs), or mass storage peripherals you have if you have more than two of one 
device. This is corrected later when you create a description of your machine from 
which to configure the ULTRIX-32 system. These messages contain much of the 
information that will be used in creating the configuration. In a correctly configured 
system most of the information present in the configuration description is printed out 
at boot time as the system verifies that each device is present. 

The ULTRIX-32 system is running in single-user mode. The # prompt is from the 
ULTRIX-32 operating system, and tells you that you are the superuser. 

2.6.2. Copy the RL02 Distributed Root to System Disk 

In this step you will copy the entire RL02 distribution onto your system disk. On a 
VAX- 11/730 system, the system disk can be an RA80, RA81 or R80. On a VAX- 
11/750 system, the system disk can be an RA80, RA81, RM03, RM05, RM80 or RP06. 

If the system disk is removable, load it into drive 1. Whether the system disk is 
removable or not, make sure it is spinning and the READY light is lit. Copy the 
RL02 distribution root to the new system disk by typing: 

# dest=xxxa devtype =dddd source=yy.y cproot 

where xxxa is the name of the destination (system) disk drive, unit number, and parti- 
tion a; dddd is the type of the destination disk (system), and yyy is the name of the 
source (distribution) disk drive (see Table 2.6.2). Table 2.6.2 is a reference of the disk 
drive ULTRIX-32 system naming conventions. 
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Table 2.6.2 ULTRIX Disk Drive Naming Conventions 



Disk 


xxxa 


dddd 


yyy 


Svstem 


RA80 


raOa 


ra80 




VAX-11/730 and 11/750 


RA81 


raOa 


ra81 




VAX-11/730 and 11/750 


R80 (IDC) 


rbOa 


rb80 




VAX-11/730 


RL02 (IDC) 






rbl 


VAX-11/730 


RL02 






rlO 


VAX-11/750 


RM03 


hpOa 


ra80 




VAX-11/750 


RM05 


hpOa 


ra80 




VAX-11/750 


RM80 


raOa 


ra81 




VAX-11/750 


RP06 


hpOa 


rp06 




VAX-11/750 



For example, if you have a VAX-11/730 with an RL02 (drive 1) and an R80 (drive 0) 
disk, type: 

# dest=rbOa devtype=rb80 source=rb1 cproot 

The system responds with something similar to: 

Warning: 36 sector(s) in last cylinder unallocated 

/dev/rrbOa: 15884 sectors in 199 cylinders of 2 tracks, 40 sectors 

8.1Mb in 13 cyl groups (16 c/g, 0.66Mb/g, 192 1/g) 
super-block backups (for fsck -b#) at: 

32, 1352, 2592, 3912, 5152, 6472, 7712, 9032, 10272, 11592, 

12832, 14152, 15392, 

DUMP: Date of this level 0 dump: Thu Apr 5 09:17:24 I984 



DUMP: dumping (Pass IV) [regular files] 
Warning: ./lost+found: File exists 
DUMP: DUMP: 2042 tape blocks on 1 tape(s) 
DUMP: DUMP IS DONE 
set owner/mode for '.'? [yn] 

Do not be concerned with the warnings. 

NOTE: Save the super-block numbers. They may prove helpful in an emergency. 
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Type y in response to the prompt: 

set owner/mode for '.'? [yn] y 

Sync, halt, and reboot the destination rbOa rb02. 

# 

Sync and halt the system: 



Now reboot the system off the new system disk (see subsection 2.6.1). Remember to 
substitute the system disk for xx, and the system drive for n. The system drive in) 
should be 0. For example, if your system disk is an RM05, substitute hp(0,0)vmunix 
for jc:c(n,0)vmunix. 

The System is Rebooted 

After the system is rebooted, use fsck to be sure the filesystem is correct: 

* fsck /dev/xxxx 

OCJCXJC IS the destination (system) disk, unit number, and partition you used in the 
cproot command above. For example, if the destination drive is an R80 in drive 0 and 
on partition a, type: 

* fsck /dev/rbOa 

In our example, the output should be similar to: 

** /dev/rbOa 

* * Last Mounted on / 

** Phase 1 Check Blocks and Sizes 
** Phase 2 Check Pathnames 

* * Phase 3 Check Connectivity 

* * Phase 4 Check Reference Counts 

* * Phase 5 Check Cyl Groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 



# sync 

# halt 



syncing disks... done 



halting (in tight loop); hit 
A P 

HALT T 

?02 PC=xxxxxxxxx 
»>H 



(type <CTRL/P>) 
(type H) 

(system counter) 



2.6.3. Set up and Install the /usr Filesystem 

In this step you will set up and restore the /usr filesystem. 
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First, set the date and time: 



# date yymmddhhmm 



Where: 



yy equals the last two digits of the year 

mm equals the number of the month of the year 

dd equals the number of the day of the month 

hh equals the hour of the day (based on 24 hours) 

mm equals the minutes of the hour 



The system will echo the new date and time. 

Now set a shell variable to the name of your system disk, its device type, and your 
source (distribution) type (rl02 or rb80). First, find your system disk drive in the fol- 
lowing list and type the commands to the right: 



For example, if your destination (system) disk is an R80, type: 

# dest=rbOh 

# devtype=rb80 

Now set up a shell variable for the source disk. It is usually rIO, but if you have A 
VAX- 11/730 with an RL02 and an R80 drive, it is rb1. For example, if you have a VAX- 
1 1 /730 system with an RL02 and an R80, type: 

# source=rb1 
Otherwise, type: 

# source=rlO 



Disk Drive Command 

RA80 dest=raOh 

RA81 dest=raOh 

R80 (IDC) dest=rbOh 

RM03 dest=hpOg 

RM05 dest=hpOg 

RM80 dest=hpOg 

RP06 dest=hpOg 



Command 



devtype=ra80 

devtype=ra81 

devtype=rb80 

devtype=rm03 

devtype=rm05 

devtype=rm80 

devtype=rp06 
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Now export the three new variables: 

# export dest devtype source 

Now restore the root fllesystem by executing the xrl script: 

# xrl 

Warning: 94 sector(s) in last cylinder unallocated 

/dev/rrbOh: 110142 sectors in 254 cylinders of 14 tracks, 31 sectors 

56.4Mb in 16 cyl groups (16 c/g, 3.56Mb/g, 1600 i/g) 
super-block backups (for fsck -b#) at: 

32, 7008, 13984, 20960, 27936, 34912, 41888, 48864, 55840, 62816, 
69792, 76768, 83744, 90720, 97696, 104672, 
Mount RL02 Distribution Pack number 1. 

Hit carriage return when pack is spinning and ready light comes on. 

NOTE: Save the super-block numbers along with the other super-block numbers. Do 
not worry about the warning. 

At this point, spin down the ROOT system disk and remove it from the drive. Load 
the distribution pack labeled 1 of 4 into the empty drive. When the disk is spinning 
and the READY light is lit, press <RETURN>. The system responds: 

rb1c: hard error snO (Once is fine, twice means problems) 

(wait about 20 minutes) 

Done with pack number 1. 

Mount RL02 Distribution Pack number 2. 

Hit carriage return when pack is spinning and ready light comes on. 

Repeat changing RL02 distribution disks until the system tells you that you have 
finished (signified with a #). 

Next, set the superuser password. The password you select must contain at least six 
characters: 

# passwd root (set password for superuser) 
New password: (password will not echo) 
Retype new password: 

# 

Now unmount the destination (system) disk drive: 

# /etc/umount /dev/${dest} 
Remember to type the braces ({}). 
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Check the consistency of the filesystem by typing: 

# fsck /dev/r${dest} 

The output from fsck should look similar to: 

** /dev/rxxxx (xxxx is your dest assignment) 

** Last Mounted on / 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

671 files, 3497 used, 137067 free (75 frags, 34248 blocks) 

If there are inconsistencies in the filesystem, the system may prompt you for correc- 
tive action; see fsck — the UNIX File System Check Program for further information. 
If serious problems exist, try the extractions again, starting with the xrl script above. 
Be sure your shell variables are defined correctly. 

Now remount the filesystem by typing: 

# /etc/mount /dev/${dest} /usr 

2.6.4. Update the Console Cassette 

If you have a VAX- 11/730 system, you need to build the boot cassette. You do this by 
copying some files from the local console cassette (that is, the cassette that came with 
your hardware), adding some files from the ULTRIX-32 system, and writing them all 
to a blank cassette. 

This new boot cassette will allow the ULTRIX-32 system to reboot automatically 
whenever necessary. 

First, remove the distribution cassette from the external TU58 drive (drive 0) and 
insert a blank cassette. Be sure the blank cassette is NOT write protected (the record 
tab should be in the left-most position). 

Make sure the local console cassette is loaded in the internal TU58 drive (drive 1). To 
locate this drive, pull out the front of the CPU like a desk drawer, and you will find 
drive 1 on the back right-hand side. 
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Then, change into the directory where the console cassette information is stored: 

# cd /sys/ cassette 

Next set up the default boot device. If you are using an IDC R80 as your primary 
root type: 

# cp defboo.rb defboo.cmd 

If you are using a drive on a UDA50 as your primary root type: 

# cp defboo.ra defboo.cmd 

To build the updated boot cassette, type: 

# make update 

(this takes about 25 minutes) 

lists all of the files on the cassette 



Console cassette update complete. 

The new cassette should be installed in the internal 

tu58 slot (Drive 1). 

# 

# 

Store the distribution cassette and the local console cassette in a safe place. The ori- 
ginal local console cassette is required to boot VAX/VMS systems. Remove the boot 
cassette you just built from the external drive and insert it in the internal TU58 
cassette drive (drive 1). 

At this point, you can make more copies of the new boot cassette by using the flcopy 
maintenance command (see arff(8V)). 

The system is now bootstrapped, and running on your system disk in single-user 
mode. Be sure to store the original RL02 distribution disks in a safe place. 

See section 3 (System Setup) for information on how to further set up your system. 
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3. System Setup 

Section 3 describes the system setup procedures for an ULTRIX-32 operating system. 
Before using the system setup procedures, your ULTRIX-32 system must first be 
bootstrapped (section 2). The only time you will need to use the system setup pro- 
cedures is the first time you install the system, or whenever you change the system 
configuration. 

The steps for setting up your system are as follows. Each step is described in the 
accompanying subsection. 

• Initialize /etc/fstab (subsection 3.1) 

• Automatic crash dumps (subsection 3.2) 

• Make device special files (subsection 3.3) 

• Build the new system images (subsection 3.4) 

• Test the new system (subsection 3.5) 

• Terminal configuration (subsection 3.6) 

• Add site-specific information (subsection 3.7) 

• Bring system to multi-user mode (subsection 3.8) 

• Add new users (subsection 3.9) 

3.1. Initialize /etc/fstab 

In this step you will initialize information about the disk partition usage in the 
/etc/fstab file. 

To initialize the information, first change directory to /etc. Then copy the fstab. file 
that corresponds with your system disk to fstab. Copy the appropriate file from the 
following list: 

fstab.ra60 

fstab.ra80 

fstab.ra81 

fstab.rb80 

fstab.rk07 

fstab.rm03 

fstab.rm05 

fstab.rm80 

fstab.rp06 

fstab.rp07 
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For example, if you have RK07 disk drives, then you should enter these commands: 

# cd /etc 

# cp fstab.rk07 fstab 

The fstab file needs a correct entry for each filesystem that you will mount and use. 
As distributed, the fstab file has entries for the most frequently used filesysterns. 

To see what your particular fstab file contains use the cat ( 1 ) command. For example, 
after copying stab.rk07 to fstab, the fstab file contains: 

# cat fstab 
/dev/hk0a:/:rw:1:1 
/dev/hk0g:/usr:rw:1:2 
/dev/hk1a:/usr/sys:rw:1:3 

If your system disks are RK07s then you need to edit the fstab file and add an entry 
for the g partition. 

But first you need to be sure newfs (8) has been executed on the g partition once. 

CAUTION: Doing a newfs destroys all data on the partition; therefore, use caution 
when using newfs. 

Then mount the partition onto the /usr directory and make the /usr/ users directory: 

# cd /usr 

# newfs rhklg rk07 

# /etc/mount hkOg /usr 

# mkdir /usr/users 

# cd /etc 

Be sure to save the numbers generated by newfs. A good place to keep them is taped 
to the outside of the disk cover (if the disk is removable). 

Now use the ed ( 1 ) editor to add an entry like this to fstab: 

/dev/hk1g:/usr/users:rw:1:4 

See The ed Command Summary Sheet, included in this document, for a brief intro- 
duction to the ed editor. 

For other types of system disks you should add an entry for /usr/users as well. See 
fstab (5) and Guidelines for System Management for further information on the fstab 
file. 

Now change directory to /, clear the mount table, and check all the file systems. To 
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do this, enter these commands: 

# cd / 

# sync 

# umount /dev/usr 

# cat /dev/null > /etc/mtab 

# sync 

# fsck 

# mount -a 

You should use the df ( 1 ) command to be sure all the filesystems are correct: 



# df 












Filesystem 


total 


kbytes 


kbytes 


percent 




node 


kbytes 


used 


free 


used 


Mounted on 


/dev/hkOa 






XX XX 


XX % 


/ 


/dev/hkOg 


X XXX 






XX % 


/usr 


/dev/hkla 




xxxx 


xxxx 


XX % 


/usr/sys 


/dev/hklg 








XX % 


/usr/users 



3.2. Automatic Crash Dumps 

If a crash occurs, two files are created: one is the kernel image and one is a copy of the 
physical memory. These files require a substantial amount of disk space. 

To prevent a crash from creating the files on the disk, the ULTRIX-32 system, as dis- 
tributed, masks the following line in the /etc/rc. local file: 

# /etc/savecore /usr/adm/ crash > /dev/console 

If you have enough disk space on your system to accommodate the crash files, in the 
event of a crash, then edit the /etc/rc. local file and remove the # masking the above 
line. 

See Guidelines for System Management for information on savecore. 

3.3. Make Device Special Files 

Special files kept in the /dev directory access the ULTRIX-32 system devices. The 
MAKEDEV shell script creates these special files. 

In this step you will install devices in your system by first creating a new device direc- 
tory, and then copying the MAKEDEV script into it. To do this, enter these com- 



86 ULTRIX-32 Installation Guide 



mands: 

# cd / 

# mkdir newdev 

# cp dev/MAKEDEV newdev 

# cd newdev 

Next, determine the ULTRIX-32 naming conventions for the devices you need to 
install. Use Table 3.1 as a guide. For example, an RP06 disk is referred to as hp, and 
a TE16 tape drive is referred to as ht. 
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Table 3.1 ULTRIX-32 Device Naming Conventions 

MASSBUS Disks MASSBUS Tape 



Disk name ULTRIX name Tape name ULTRIX name 

RM03 hp TE16 ht 

RM05 hp TU77 ht 

RM80 hp TU78 mt 

RP06 hp 
RP07 hp 

UNIBUS Disks UNIBUS Tapes 

Disk Name ULTRIX Name Tape Name ULTRIX Name 

RA60 ra TS11 ts 

RA80 ra TU80 ts 

RA81 ra 
RC25 ra 
RK07 hk 
RL02 rl 

Communication Devices Other Devices 

Device Name ULTRIX Name Device Name ULTRIX Name 
DMF32 dmf LP11 lp 

DZ11 dz 
DZ32 dz 

IDC Disks 

Disk Name ULTRIX Name 
RL02 rb 
R80 rb 



Now that you have determined the device names, run the MAKEDEV script. To run 
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MAKEDEV, enter the following: 

# MAKEDEV devl dev2 ... std 

where devl dev2 ... are the device name and unit number of each device you need to 
install. For example, the first DZ-11 multiplexor would be called dzO. You must 
include std in the argument list, std causes MAKEDEV to create special files for 
standard devices such as the machine console (/dev/console), the console floppy disk 
interface for the VAX-11/780 (/dev/floppy), and the console cassette interfaces for the 
VAX-11/750 and VAX-11/730 ( /dev/tuO and /dev/tul ). 

For example, suppose your system has these devices: 

two DZ-11 multiplexors 

one DMF-32 multiplexor 

an RM03 disk as drive 0 

an RP06 disk as drive 1 

one TE16 tape drive 
In this case you would use this MAKEDEV command line: 

# MAKEDEV dzO dz1 dmfO hpO hp1 htO std 

Finally, replace the old special files with the new special files you just created. To do 
this, enter the following commands: 

# cd / 

# mv dev olddev ; mv newdev dev 

# chmod 755 dev 

# sync 

3.4. Build New System Images 

In this step you will build a new system image (kernel) of your system using the config 
program. 

These are the basic steps: 

1. Create a configuration file for your system. You can either modify an existing 
file distributed with the ULTRIX-32 system, or create a configuration file from 
scratch. 

2. Make a directory in which the system will be constructed. 

3. Run config on the configuration file, config generates the files required to com- 
pile and load the system image with make ( 1 ). 

4. Construct source code interdependency rules for the configured system. 

5. Compile and load the system with make. 

This procedure results in a configured system image called vmunix. 
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Read the document Building an ULTRIX-32 System with Config, included in this 
binder, for a detailed description of how to perform these steps. 

3.5. Test the New System 

In this step you should test the new system and make sure it boots properly. 

Your current working directory should now be /sys, which is where your system was 
configured. For example, if your configuration file is called MYVAX, the configuration 
procedure should have left you in the /usr/ sys /MYVAX directory. 

First, copy the system image to the root directory. Name the new copy /newvmunix to 
avoid destroying the working system until you are sure it works: 

# cp vmunix /newvmunix 

# sync 

# cd / 

# umount -a 

Now halt the processor by typing: 

# halt 

The system responds with messages, and eventually tells you to press "P. Press 
<CTRL/P> to return to the console subsystem, which has a »> prompt: 

"P 

»> 

If you have a VAX- 11/780, type the following: 

»>H 

HALTED AT xxxxxxx 
»>U 
>»l 

INIT SEQ DONE 

Now boot the system. If you have a VAX- 11/780 or VAX- 11/730, type: 
»> B ANY 



(halt the processor) 
(program counter) 
(unjam the SBI) 
(initialize the processor) 
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If you have a VAX- 11/750, type: 
»> B/3 

After printing some boot information, the system responds with this prompt: 
Boot 

Now type xjc(n,0)newvmunix, where xx(n,0) is the device specification you used to 
boot the completed root file system (see section 2). 

Boot 

: jcjc(«,0)newvmunix 

After you have typed the device specifications, the system displays several lines of 
information. When you receive a # prompt, you know the system has booted prop- 
erly, and you are now running in single-user mode. 

Every time you make a new kernel you should copy the old version of the system to 
another file before installing the new system. You should make this backup copy once 
you feel comfortable with the new system — you can run fsck to check the file system. 

To make a backup copy and install the new system image, enter these commands: 

# mv vmunix genvmunix 

# mv newvmunix vmunix 

# sync 

# /etc/mount /usr 

NOTE: Keep a permanent copy of the old system under a different name. In particu- 
lar, retain the generic distribution version of the system permanently as /genvmunix 
for use in emergencies. 

3.6. Terminal Configuration 

In this step you will configure terminals to allow simultaneous access to your system 
by many users. The configuration procedure assumes: 

• The devices have been configured in to the system with an appropriate line in the 
configuration file (see Building an ULTRIX-32 System with Config). 

• A special file exists in the /dev directory for each device (see subsection 3.1 for 
MAKEDEV information). 

To configure your terminals do the following: 

1. Edit the /etc/ttys file, (see ttys(5)) The /etc/ttys file contains a list of termi- 
nal names. By convention, terminals connected via dz interfaces are named ttyDD 
where DD is a decimal number, also known as the minor device number. The lines 
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on dzO are named /dev/ttyOO, /dev/ttyOl, ... /dev/tty07. Lines on dmf interfaces 
are named ttyhX, where X is a hexadecimal digit. If more than one dmf interface 
is present in a configuration, successive terminals are named ttyiX, ttyjX, etc. 

NOTE: Do not use arbitrary terminal names, because accounting programs and 
the ps ( 1 ) command use the last two characters of the tty naming conventions. 

The first character of each line is either a 0 or a 1. If the first character is a 1, the 
init ( 8 ) program creates a login process for that line. To add a new terminal to 
your system, change the first character of the appropriate line of /etc/ttys to 1, or 
add a new line to the file if necessary. 

NOTE: Do not remove the 1 from the line describing the console terminal. 

The second character of each line lists the speed and initial parameter settings for 
the terminal. (See gettytab(5) for a complete explanation of the parameter set- 
tings, and look at the /etc/gettytab file.) The most common choices are: 

0 300-1200-150-110 

2 9600 

3 1200-300 

4 300 (console) 

5 300-1200 
8 9600-300 

For example, the line 12tty00 in the /etc/ttys file describes a new terminal 
(/dev/tty00) set to run at 9600 baud. The line 10tty62 describes a new terminal 
(/dev/tty62) set to run at 300, 1200, 150, 110 baud. In this case, the terminal 
would start up at the first speed (300). The user could then switch to the 
appropriate speed for his particular terminal by pressing the <BREAK> key. 

2. Edit the /etc/ tty type file. The /etc/ttytype file contains a list of terminal types 
for each tty port on the system. For example, the line vtlOO tty OO identifies 
ttyOO as a VT100 terminal. Edit the /etc/ttytype file, adding the type of each ter- 
minal on your system (see ttytype(5) for details). Use the /etc/ttytype file distri- 
buted with the system as a model. 

3. Set dialup terminals. For dialup lines, carrier is not assumed, therefore you 
must be sure to set the flag in / sys / conf / MACHINENAME. For hardwired termi- 
nals, the system configuration file (/ sys/ conf /MACHINENAME) must show that 
the carrier is assumed to be present. See dz(4), and dmf (4) for further informa- 
tion. 

NOTE: The ULTRIX-32 operating system currently supports no more than 100 
terminals. 

Next, change the names of any dialup lines to ttydx where x is in the range [0-9] 
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or [a-f]. Some programs use this naming convention to determine if a terminal is a 
dialup. 

For example, suppose you want to set lines tty06 and tty07 to make dialup termi- 
nals. First change the name of the devices in the /dev directory with commands 
similar to these: 

# mv tty06 ttydO 

# mv tty07 ttyd 1 

Now change the names of the new dialup lines in the /etc/ttys file. An example of 
a dialup line entry in this file is: 

13ttyd0 

Finally, change the names of the dialup lines in the /etc/ttytype file. A example 
entry of an entry in the /etc/ttytype file for a dialup terminal is: 

dialup ttydO 

You may also wish to set the flags field. This flag is explained in section 1.2.3 of 
Building an ULTRIX-32 System with Config. 

You can automate this process by putting the commands needed to change line names 
in the / dev / MAKEDEV. local file. 

3.7. Site Tailoring 

In this step you will set your system specifications. All programs that require the 
site's name, or site specific information obtain the information through system calls, or 
from files located in /etc. 

To tailor your system site, edit the files / etc /rc. local and /etc/ hosts. Choose a site 
name, and add it to the first line of both files. 

In the / etc /rc. local file, substitute the name of your site for myname in the following 
line: 

/bin/hostname myname 

This line defines the value returned by the gethostname(2) system call. Programs 
such as getty(8), mail(l), wall(l), uucp(l), and who(l) use this system call. 

In the /etc /hosts file, substitute the name of your site for myname in the following 
line: 

127.1 myname localhost 
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3.8. Bring the System to Multi-user Mode 

You are now ready to bring the system to multi-user mode. To do this, type 
<CTRL/D>. The system responds with system related information, followed by a 
login prompt: 

# A D 



(system related information) 



login: 

The login prompt should appear on every terminal you configured in to the system. 

NOTE: If the login prompt does not appear on the terminals, check the flag settings 
on the dz and dh entries in the configuration file for your system, 
/sys/conf/MACHINENAME. If the flags are set, you can wire terminals in to the sys- 
tem with no modem control. If the flags are not set, the line requires carrier. If 
necessary, set the flags for hardwired lines that are not properly wired. See dz ( 4 ) and 
dh(4) for details. 

Once you receive the login prompt, log in to the system as root and add new users to 
the system: 

login: root 
Password: 

# 

NOTE: Your system prompt will actually be sitenamett, which indicates you are 
logged in as root and the system is in multi-user mode, sitename is the name of your 
particular site which you entered in the / etc/ rc. local and /etc/hosts files. 

For the rest of this document, # indicates the superuser prompt, regardless of whether 
the system is in multi-user mode or single-user mode. 

3.9. Add New Users 

In this step you will add login accounts for the initial user community. Each login 
account needs an entry in /etc/passwd and a login, or home, directory. 

First, select a location (disk and partition) for the directory called /usr/ users that will 
hold the home directories. Second, create /usr/ users, and if the directory has its own 
partition, mount the partition. Once these steps are completed, you are ready to add 
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accounts to the system. Section 3.1 of Guidelines for System Management explains in 
detail how to add accounts. 

If at all possible, you should place /usr/ users on its own separate partition. For 
better performance and ease of maintenance, you should try to locate this partition on 
a disk other than the system disk. If you do not have a separate disk available, how- 
ever, a partition on the system disk will work. 

To learn which partitions are available, you need to determine which partitions over- 
lap, and which partitions are in use. Use the mount (8) command to see a table of all 
the file systems and the partition each is using: 

# /etc/mount 

Table 5.1 lists the partitions for most major disk drives, their sizes, and their typical 
uses. 

3.9.1. Separate Partition Is Available 

A partition of a disk separate from the system disk is the best location for the home 
directories. If your system can accommodate this situation, then choose a partition on 
the separate disk to contain /usr/users. 

If no partition is available on a disk other than the system disk, then the second best 
choice is an unused partition on the system disk. For example, suppose you have only 
one disk, an RA81, and /usr is on partition h; partition g is available. In this situa- 
tion, the best location for /usr/users is partition g (raOg). 

Now add an entry for the partition to / etc /f stab. The entry ensures that the file sys- 
tem will be checked automatically and mounted on reboot. For example, in our case 
above with the RA81 disk, the entry in / etc /f stab should be: 

/ dev/ raOg: / usr / users:rw: 1 :3 

NOTE: The order of the entries in / etc /f stab is important. For example, the fstab 
entry for /usr must appear before any other entries that are mounted on /usr. See 
fstab (8) for more information on the format and meaning of entries in this file. 

The new partition (raOg, in our example) must contain a file system. Use the 
newfs(8) command to create the file system. For example: 

# /etc/newfs raOg ra81 

CAUTION: If you create a file system on a partition that already contains files, all 
the files will be destroyed. 
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The next command creates the empty directory /usr/ users: 

# mkdir /usr/ users 

Use the mount (8) command: 

# /etc/mount /usr/users 

Proceed with subsection 3.9.3. 

3.9.2. Separate Partition is not Available 

If you do not have any separate partitions available (either on the system disk or any 
other disk), simply create /usr/users. The user files will then occupy space on the 
/usr partition of the system disk. 

# mkdir /usr/ users 

3.9.3. Add the User Accounts 

You are now ready to add the new user accounts. The document Guidelines for Sys- 
tem Management (also included in this binder) describes in detail how to create the 
new user accounts. These are the basic steps: 

• Create a user entry in /etc/passwd. 

• Create a user home directory. 

• Copy the shell startup files. 

• Change the UIDs and GIDs assigned to the newly created files. 

This completes your ULTRIX-32 system installation for a standard system 
configuration. The remainder of this document supplies information for network 
configuration, fine-tuning your system, dealing with nonstandard configurations, and 
additional setup information such as sendmail and uucp. 



4. Network Setup 
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The ULTRIX-32 system provides support for the TCP, IP, and UDP protocols. Sec- 
tion 4 describes how to configure your system to use the networking support. 

If your machine is not connected to another machine, read subsections 4.1 and 4.2. If 
you plan networking links to other machines, read the entire section. 

Programs such as mail(l), talk ( 1 ), script (1), and the line printer daemon lpd(l) 
rely on information outlined in this section to function properly. This section contains 
three subsections: 

• The Configuration File 

Subsection 4.1 outlines the steps to configure network hardware into your machine. 
It also tells how to configure pseudodevices that the system needs even if your 
machine is not connected to other machines. 

• Network Databases 

Subsection 4.2 discusses the database files that the network library routines and 
server programs use. You need to add site-specific information to some of these 
files; others can remain unaltered. 

• Routing and Gateways 

Subsection 4.3 explains how to set up routing information so that packets can be 
routed correctly. It is relevant for ARPANET sites, or sites running large, complex 
networks. 

4.1. System Configuration 

Section 4.1 outlines the steps required to configure networking hardware into your sys- 
tem. It discusses the needed information in your machine's configuration file, and how 
to configure pseudodevices. 

4.1.1. The Configuration File 

To configure network hardware in your system, place an appropriate entry in the 
configuration file for your machine, /sys/conf/ MACHINE (MACHINE, written in capi- 
tal letters, is the name of your system). The appropriate entry depends on the kind of 
hardware you plan to configure. Refer to section 4 of the ULTRIX-32 Programmer's 
Manual (for example de(4)) for the description of the intended device, then check 
the SYNTAX section to get the exact wording for the entry. Here are the supported 
devices: 
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Device Name Description 

de DEUNA Ethernet 

dmc DMR-11 (in DMC mode) 

For example, to configure a DEUNA Ethernet interface, refer to de(4), then edit 
your configuration file, adding this line: 

device deO at uba? csr 0174510 vector deintr 

4.1.2. Configuring Multiple Networks 

The order in which devices are listed in the configuration file is important. If you are 
configuring more than one network in your system, list the most widely known net- 
work first. For example, if your machine is connected to both the ARPANET and a 
local network, list the device connected to the ARPANET first. 

4.1.3. Configuring Pseudoterminals 

Whether or not your machine is connected to a network, programs such as mail, talk, 
and Ipd depend on information defined in your machine's configuration file to operate 
properly. The ULTRIX-32 system is distributed with this information already 
included. 

Specifically, a properly installed ULTRIX-32 system defines the INET option in the 
configuration file for your machine. The configuration file also includes definitions for 
these pseudodevices: 

Pseudodevice Name Function 



inet Includes IPC and network code 

pty Forces pseudoterminal device driver to be configured 

into the system 

loop Used by mail system and in network testing 

ether Maps Internet and Ethernet addresses 

Do not remove these pseudodevice specifications from your configuration file. 

To use the pseudoterminals, create device entries for them in the /dev directory. The 
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following creates entries for 16 pseudoterminals: 

# cd /dev 

# MAKEDEV ptyO 

Sixteen entries is adequate for most networking needs. If you have a heavy network 
load, you can create additional pseudoterminal entries by adding pty 1 and pty2 to the 
command line. 

This procedure actually creates two files in /dev for each pseudoterminal: a master 
file, and a slave file. The master pseudoterminal files are called /dev/pty[p-r][0-9a-f]; 
the slave pseudoterminal files are called /dev/tty[p-r][0-9a-f]. The MAKEDEV com- 
mand above creates a total of 16 master pseudoterminals and 16 slave pseudotermi- 
nals. 

The master pseudoterminals are: 

ptypO 
Ptypl 
ptyp2 
ptyp3 
ptyp4 
ptyp5 
ptyp6 
ptyp7 
ptyp8 
ptyp9 

The slave pseudoterminals are: 

ttypO 
ttypl 
ttyp2 
ttyp3 
ttyp4 
ttyp5 
ttyp6 
ttyp7 
ttyp8 
ttyp9 

Now install the pseudoterminals by making sure there is an entry for each slave pseu- 
doterminal in the /etc/ttys and the /etc/ttytype files. The /etc/ttys file lists the ter- 
minals connected to your machine, and the /etc/ttytype file identifies each terminal 
type. 

If some of the entries are missing from the /etc/ttys file, edit the file, and add the 
necessary lines. The /etc/ttys file should contain one entry per slave pseudoterminal 



ptypa 
ptypb 
ptypc 
ptypd 
ptype 
ptypf 



ttypa 
ttypb 
ttypc 
ttypd 
ttype 
ttypf 
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created by the MAKEDEV command: 

02ttyp0 
02ttypl 
02ttyp2 



02ttyp9 
02ttypa 
02ttypb 



02ttypf 

The zero (0) in the first column prevents a getty(8) process from starting on these 
terminals when the system goes into multi-user mode. The two (2) in the second 
column specifies the baud rate; however, because getty(8) will ignore the entry, the 
two is significant only as a place-holder. 

Now be sure each pseudoterminal is identified as type network in the /etc/ttytype file. 
If /etc/ttytype is missing any entries, edit the file and add any necessary lines. In our 
example, the /etc/ttytype file should contain the following lines — one per slave pseu- 
doterminal listed in /etc/ttys: 

network ttypO 
network ttypl 



network ttyp3 
network ttypa 
network ttypb 



network ttypf 

4.2. Network Data Bases 

Network library routines and server programs rely on information contained in several 
data base files. A few of these files must be altered to reflect site-specific information; 
others remain untouched. Because some files need altering, even if you do not plan 
networking at your site, you should be aware of these data base files. Table 4.2.1 lists 
these files and provides a brief description of each. 
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Table 4.2.1 Network Data Base Files 



Table 4.2.1 Network Data Base Files 



File 


Manual 
Reference 


Function 


Action Required 


/etc/rc.local 


rc(8) 


Script for starting 
servers 


Requires modification, even if your 
machine is not on a network. 


/etc/hosts 


hosts (5) 


Host names 


Requires modification, even if your 
machine is not on a network. 


/etc/networks 


networks (5) 


Network names 


Requires modification, even if your 
machine is not on a network. 


/etc/hosts.equiv rshd ( 8C ) 


Trusted hosts 


Requires site-specific network informa- 
tion. Be careful when you set up this 
file. 


/etc/ftpusers 


ftpd(8C) 


Unwelcome ftp users 


Requires site-specific network informa- 
tion. 


/etc/ser vices 


services (5) 


Network services 


No modification necessary. 


/etc/protocols 


protocols ( 5 ) Protocol names 


No modification necessary. 



The following subsections provide details on these network databases. 
4.2.1. Editing the /etc/rc.local File 

The /etc/rc.local file contains site-dependent information needed at boot time. Edit 
this file using the ed ( 1 ) editor so it contains local information, even if your machine is 
not on a network. For a brief description of how to use ed see The ed Command 
Summary Sheet included in this document. 

Identify your machine name in the first line of the /etc/rc.local file. To do this, edit 
/etc/rc.local, and modify this line by substituting myname with the name you choose 
for your machine: 

/bin /hostname myname 

For example, if you decide to call your machine myvax, substitute myvax for 
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myname. The line should now read: 
/bin /hostname myvax 

The / etc /rc. local file should also include a call to the ifconfig(8C) program that 
identifies your machine's name to the network interface at boot time. If your inter- 
face is something other than a DEUNA, edit the / etc /rc. local file substituting your 
interface for deO in the following line: 

/etc/ifconfig deO Vbin/hostname v 



Your substitution for deO should be comprised of the interface device name and unit 
number. For example, the first device you configure to a DMR-11 interface is called 
dmrO; the second is dmrl, and so forth. The first device is the one listed first in your 
machine's configuration file. The appropriate line for the first device on a DMR-11 
interface is: 

/etc/ifconfig dmrO v /bin/hostname N 

NOTE: Enclose the word /bin /hostname with back quotation marks 0), not single 
quotation marks. Refer to the device descriptions in section 4 of The ULTRIX-32 
Programmer's Manual for device name abbreviations. 

The /etc/rc. local file is used in conjunction with the /etc/rc file at boot time. The 
/etc/rc file automatically starts these network servers: 

Server Name Function Manual Reference 



/etc/rshd Remote shell server rshd(8C) 

/etc/rexecd Remote execution server rexecd(8C) 

/etc/rlogind Remote login server rlogind(8C) 

/etc/rwhod System status daemon rwhod(8C) 

The site-dependent /etc/rc. local file includes by default commands to start other net- 
work servers. If you want these other network servers started at boot time, be sure to 
retain commands such as the ones shown here in /etc/rc. local: 

if [ -f /etc/telnetd ]; then 

/etc/telnetd & echo -n ' telnetd' >/dev/console 

fi 

NOTE: These particular commands start the TELNET server. Commands for other 
servers take a similar form. 

The /etc/rc. local file for the ULTRIX-32 system is distributed with commands to 
start the following servers: 
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Server Name 



Description 



Manual Reference 



* /etc/telnetd 

* /etc/ftpd 



TELNET server 

FTP server 

Error logging server 



telnetd(8C) 
ftpd(8C) 
syslog(8) 
sendmail(8C) 
routed (8C) 



/etc/syslog 
/etc/sendmail 
* /etc/routed 



SMTP server 

Network routing daemon 



If you are on a network, you need all the servers listed; if you are not on a network, 
you do not need the servers marked with an asterisk (*). 

If you do not need a server, either mask the appropriate lines in the / etc /rc. local file, 
or remove the server from the /etc directory. To mask a line, place a number sign 
(#) at the beginning of it. For example, masked lines for the TELNET server look 
like this: 

#if [ -f /etc/telnetd ]; then 

# /etc/telnetd & echo -n ' telnetd' >/dev/console 



Consult The ULTRIX-32 Programmer's Manual for information concerning a particu- 
lar server. For example, telnetd (8) describes the TELNET server. Also consult the 
Sendmail Installation and Operation Guide, for information on sendmail, and its rela- 
tionship to the servers. 

4.2.2. Editing the /etc/hosts and /etc/networks Files 

The /etc /hosts file contains information identifying host names. The /etc /networks 
file lists network names and numbers. You use different procedures to generate both 
the /etc /hosts file and the /etc /networks file, depending on whether your site is con- 
nected to the ARPANET. The following two sections provide the information to gen- 
erate these files. 

4.2.2.1. Sites Connected to the ARPANET 

If you are an ARPANET site, you generate the /etc /hosts and /etc /networks files by 
using information retrieved from a network data base at the Internet Network Infor- 
mation Center (NIC) at Stanford Research Institute. Follow the steps in the next 
paragraph to generate these files. 

In the procedure listed in the following example, you use the /etc/gettable program to 
retrieve the NIC host data base. Then you use the /etc/htable program to convert 



#fi 
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this data-base information to the format required by network library routines. 

# cd /usr/src/ucb/netser/htable 

# /etc/gettable sri-nic 
Connection to sri-nic opened. 
Host table received. 
Connection to sri-nic closed. 

# /etc/htable hosts.tst 
Warning, no localgateways file. 
# 

The htable program generates hosts and networks files and places them in the current 
directory (/usr/src/ucb/netser/htable). If you want to make local modifications to 
these files (to define local hosts or networks, for example), create files in the current 
directory called localhosts and localnetworks. The htable program incorporates the 
information in the localhosts and localnetworks files when it creates /etc /hosts and 
/etc /networks. Refer to hosts (5) and networks (5), for the format to use for these 
locally-generated files. 

Before installing the newly-modified hosts and networks files in the /etc directory, 
you should compare the old files with the new ones using diff(l). 

To install the hosts and networks files in the system, type: 

# mv hosts /etc /hosts 

# mv networks /etc /networks 

4.2.2.2. Sites Not Connected to the ARPANET 

If your machine is not connected to the ARPANET, you must modify the /etc /hosts 
and /etc /networks files by hand. The contents of these files varies slightly depending 
on whether your machine is connected to other machines. 

If your machine is not connected to other machines: 

Your ULTRIX-32 system must have the /etc /hosts and /etc /networks files, even if 
your machine is not connected to other machines. Programs such as mail(l), talk ( 1, ) 
and the line printer daemon rely on these files to function correctly. 

For machines not connected to other machines, edit the /etc /hosts file. In the follow- 
ing line in /etc /hosts, substitute the official name you chose for your system for 
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myname, and substitute any short abbreviation for my: 

127.1 myname localhost my 

For example, if the official name of your machine is myvax (defined in the 
/bin/hostname command in the /etc/rc. local file), and you choose m to be the abbre- 
viation for myvax (the abbreviation is a shorthand version of the machine name; it 
should not contain punctuation characters), the edited line in /etc /hosts should look 
like this: 

127.1 myvax localhost m 

NOTE: Type 127.1 and localhost literally. 

Do not edit the /etc /networks file if your machine is not connected to other machines. 
The contents of /etc /networks should be: 

loop 127 loopback 
If your machine is connected to other machines: 

If your machine is connected to others machines, /etc /hosts should contain informa- 
tion identifying the machines with which your machine is connected. For example, if 
your machine is connected in a local network, you need to identify the connected 
machines in /etc /hosts. 

As distributed, the /etc /hosts file reads: 
127.1 myname localhost my 

Edit this file so that the line reads: 
127.1 localhost 

Keep this as the first line. Then add a line containing your netaddress, the official 
name of your machine (as defined in your machine's /etc/rc. local file), and your 
official abbreviation. The netaddress is a number describing the address of your 
machine on a network, and takes the form: 

netnumber. machinenumber 

netnumber is a number describing the network in question. All sites on the same net- 
work have the same number, netnumber is a number of your own choosing, less than 
127. It is best to choose a low number, machinenumber identifies the machine on the 
network. If you are using Ethernet hardware with Address Resolution Protocol, 
machinenumber is a number of your own choice. It is best to choose a low number. 
If you are not using Ethernet hardware, machinenumber is often the low byte number 
of the physical device address. 

Add similar lines for each additional site on your network. 
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For example, suppose your machine is called myvax, and is connected through a local 
network identified as 1 to two other machines called hisvax and hervax. The edited 
/etc /hosts file for myvax should be similar to: 



127.1 


localhost 




1.1 


myvax 


m 


1.5 


hisvax 


h 


1.17 


hervax 


hr 



NOTE: These guidelines tell you how to configure class A networks with no sub- 
netrouting. 

The /etc /networks file contains information describing every network to which your 
machine is connected. For each network to which your machine is connected, add one 
line in the /etc /networks file containing information in the following format: 

networkname networknumber alias 

In this format, networkname is the name of the network; networknumber is an identi- 
fying number for the network; and alias is an alternate name for the network, used by 
netstat ( 1 ) and other networking programs. 

For example, if your machine is connected to the local DMR-11 network, and 1 is the 
identifying number for the network, edit the /etc /networks file, adding a line like this: 

dmrnet 1 dmrnetwork 

If your machine is connected to another network as well, add another similar line 
describing that network. 

For more information concerning the format of /etc /hosts, and /etc /networks, con- 
sult hosts (5) and networks (5). 

4.2.3. Editing the /etc/hosts.equiv File 

The remote login program rlogind(8C) and the remote shell server rshd(8C) authenti- 
cate user requests based on a list of trusted host names. Trusted hosts are machines 
considered secure, or under similar administrative control. Thus, if a user has an 
account on two equivalent machines (that is, both machines trust each other), the user 
can execute commands and log in to a remote machine from his own, without pass- 
word verification on the remote machine. 

The /etc/hosts.equiv file contains the names of trusted hosts. Edit this file to contain 
the names of your system's trusted hosts. List the official name of each machine, one 
machine name per line. Official machine names are defined in each machine's 
/ etc /rc. local file. 
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The /etc/ hosts. equiv file as distributed contains: 
myname 

Edit /etc /hosts. equiv, substituting the name of your system's trusted hosts for 
myname. Then add the official names of your system's other trusted hosts. 

For example, if the official names of your system's trusted hosts are hisvax and her- 
vax, and your system's name is myvax, the edited /etc /hosts. equiv should look like: 

myvax 
hisvax 
hervax 

4.2.4. Editing the /etc/ftpusers Files 
4.2.4.1. The FTP Account 

The ULTRIX-32 system provides support for an anonymous ftp (File Transfer Proto- 
col) account. The account offers a location for users logging in through ftp to deposit 
and retrieve files from local users. You may want to create an anonymous account on 
your machine for guest users for any of these reasons: 

• You are running ftp. 

• You are on the the ARPANET or are talking to many other machines. 

• Your machine communicates with nontrusted sites. 

Security problems are inherent to such an account. To reduce the risk of tampering, 
there are restrictions imposed on the ftp account. When a remote user accesses this 
account, the ftp server ftpd(8C) executes a chroot(2) system call. This call confines 
the user to a restricted part of the file system that contains the ftp home directory. 

Here are the steps to set up a guest ftp account. This procedure creates a subdirec- 
tory in the ftp home directory called pub. Local users who wish to place files in the 
anonymous area should put them in ~ftp/pub. The procedure also provides the ftp 
server process with the programs and files it needs to execute properly, and ensures 
that all directories (other than ~ftp/pub) and executable images are unwritable. The 
steps are: 
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# cd ~ftp 

# chmod 555 .;chown ftp .; chgrp ftp . 

# mkdir bin etc pub 

# chown root bin etc 

# chmod 555 bin etc 

# chown ftp pub 

# chmod 777 pub 

# cd bin 

# cp /bin/sh /bin/Is . 

# chmod 111 sh Is 

# cd ../etc 

# cp /etc/passwd /etc /group . 

# chmod 444 passwd group 

This procedure limits the commands available to the ftp account to Is ( 1 ) and the shell 
sh(l). You can make more commands available, but it is wise to be conservative. 

4.2.4.2. The /etc/ftpusers File 

The /etc/ftpusers file contains names of unwanted users. The ftp server process 
checks this file on each connection. If the user's name appears in the unwanted list, 
the ftp server denies the unwanted user access to the machine. This prevents poten- 
tially destructive users from logging in to the ftp account on your machine. As distri- 
buted, the /etc/ftpusers file contains: 

uucp 

ingres 

root 

Edit this file if necessary, adding any unwanted user login names. 
You can delete the /etc/ftpusers file if: 

• Your machine is not on a network. 

• You have removed the ftp server /etc/ftpd. 

4.2.5. The /etc/services File 

The /etc/ services file maps network service names (for example systat, netstat, and 
smtp) to port numbers, and the protocol each service requires. Do not alter this file. 

4.2.6. The /etc/protocols File 

The /etc /protocols file maps protocol names (for example TCP, IP, and ICMP) to 
protocol numbers. Do not alter this file. 



ULTRIX-32 Installation Guide 109 



4.3. Routing and Gateways 

Sites on the ARPANET and sites with large complex networks need to set up routing 
information so that packets can be properly routed. This subsection describes two 
methods of setting up the routing information: 

1. Using the routing table daemon /etc/routd to maintain system routing tables. 

2. Obtaining information from a smart gateway to dynamically create a routing data- 
base. This method is appropriate for ARPANET sites only. 

Read this subsection if you access networks that are not directly attached to your host 
and need to set up routing information. 

4.3.1. Maintaining Routing Tables with /etc /routed 

The routing table management daemon /etc /routed uses a variation of the Xerox 
Routing Information Protocol to maintain up-to-date routing tables. The method 
/etc /routed uses to maintain a routing table is: 1) start /etc /routed from the 
/ etc /rc. local file 2) read the /etc /gateways file 3) install the routes defined there. 
The routed daemon then broadcasts on each local network to locate other routing dae- 
mons, that is, other machines that are running the same type of routed daemon. If the 
routed daemon receives responses, all the routing daemons cooperate to maintain glo- 
bally consistent routes for the local environment. 

It is also possible for /etc /routed to cooperate with remote sites running routing dae- 
mons to maintain a table with routes for remote sites. Refer to routed (8C) for more 
information. 

4.3.2. Using a Smart Gateway to Create a Routing Data Base 

Sites on the ARPANET can choose to rely on information provided by a smart gate- 
way to create a routing data base. By defining a wildcard route to a smart gateway, 
you can rely on the smart gateway to provide ICMP routing redirect information. To 
define a wildcard route, edit the / etc /rc. local file, adding an entry of this form: 

/etc /route add 0 smartgateway 1 

The wildcard route is indicated by a destination of 0 (zero). Refer to route (8C) for 
more information. 

The system uses the wildcard route as a last resort to route packets to their destina- 
tion. If the destination receiving the packets is able to generate the proper routing 
redirect information, the system adds routing table entries based on that information. 

There are disadvantages to this approach. It is unsuitable in environments with pseu- 
dogateways that cannot generate routing redirect information. Also, if you rely on the 
smart gateway to provide up-to-date routing information and the smart gateway goes 
down, there is no practical way to maintain service. 

ARPANET sites can choose to combine these two approaches. For example, you can 
use the routing table daemon to maintain routing information for local networks, and 
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use smart gateways for routing information for more distant networks. The netstat(l) 
command displays routing table contents and other routing information. The com- 
mand netstat -r displays the contents of routing tables. Adding the option -s to the 
command indicates the number of routing table entries dynamically created from 
routing redirect information (netstat -r -s). 
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5. Additional Setup Information 

Section 5 provides additional system setup details that you will need once your system 
is up and running and you are familiar with the needs of your users. 

The additional information covered in this section is as follows: 

• Subsection 5.1 provides information for fine tuning the system's disk configuration. 

• Subsection 5.2 provides an overview of the line printer facility. 

• Subsection 5.3 briefly describes the mail facility. 

• Subsection 5.4 describes how to set up a UUCP connection. 

5.1. Fine Tuning the Disk Configuration 

This section provides information on file system layout and gives suggestions for 
better system performance. 

5.1.1. Disk Filesystem Partitions 

Each physical disk drive can have up to eight partitions; ULTRIX-32 typically uses 
only three or four partitions. 

Some of the partitions overlap. Therefore, you should choose partitions carefully. 
The cylinders given in Table 5.1 will help you with the decisions. 

Table 5.1 gives the use of each partition for each type of drive. Throughout the table, 
? refers to the drive unit number. 

Table 5.1 Disk Drive Partitions and Their Typical Uses 



Disk 


Part- 




Starting 


Sector 




Drive 


ition 


Typical Use 


Sector 


Length 


Cylinders 


RA60 


ra?a 


root file system 


0 


15884 


0-94 




ra?b 


paging & swapping area 


15884 


33440 


95-294 




ra?c 


access entire pack 


0 


400176 


0-end 




ra?g 




49324 


82080 


295-783 




ra?h 


/usr file system 


131404 


268772 


784-end 


RA80 


ra?a 


root file system 


0 


15884 


0-37 




ra?b 


paging & swapping area 


15884 


33440 


38-115 




ra?c 


access entire pack 


0 


237212 


0-end 




ra?g 




49324 


82080 


116-305 




ra?h 


/usr file system 


131404 


105808 


306-end 
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R A81 


ra?a 


luuii me oyoi/ciii 


0 


1 ^884 


0 99 




rn9V» 
id; u 


pdglllg 06 oWdppiIlg died 


1 ^884 


33440 


93 M 




ra?c 


access entire pack 


0 


891072 


0-end 




ra?d 




340670 


15884 


478-500 




Id. c 






OOZfOlJ 


f;01 




1 a. • 1 




412490 


478582 


580-ptid 




va f or 

id. g 




4Q394 


89080 


70-1 84 




ra?h 


/ tioi nit; oybttJiii 


1 31 404 


/ OTODO 


xoo-ciiu. 


R80 


rb?a 


root file system 


0 


15884 


0-36 




rb9b 


pdglllg 06 oWdppiIlg died 




33440 


37-1 14 




T*n ' p 

1 HJ • ^ 


npppsiei pttHtp nark 
atV/COO ciiuic pcn*xv 


o 


242606 






rh9<r 
ru . g 




4QQ10 


89080 


lit; <)oa 




rb?h 




132370 


110143 


305-558 


RK07 


Ilxv . d 


TTinT Til A OArCTOTYl 

luui iiic ojr&i/cm 




1 ^884 


0-940 




hk?b 


paging oWdppiIlg C11CCI 


15906 


1 0032 


241-3Q9 




IliV . C 


dl/CCOo clinic pativ 






0 814 




nK :g 


/ Uol lllc oyol/Clll 


9fi004 




QQO Q1 q 


RL02 


rl?a 


root file system 


0 


15884 


0-397 






^Jctgillg Oo DWct^jpillg 




4480 


3Q8 ^10 




rl?c 


£iPPPQQ PTtKtP TlflpU" 

Clv/V/Cljij C-ll l/l-l \5 k/Clv/JY 


o 


20480 


0-51 1 




rl?d 




15920 


4520 


398-510 




rl?g 


/usr file system 


0 


20440 


0-510 


RL02 


rb?a 


root filp qvtst^pm 


o 


15884 


0-397 




rb?b 


pdglllg Oo oWdppiIlg died 


IfiOOO 


4480 






1 U i U 


Q/^POCC PY1T1TP hqpI 7 

dl/V/C&o clinic pdCJV 




90480 


0-^1 1 

VJ-«J1 1 


RM03 


hr»9a 
up . d 


Tr\nT Tllp 017CTPTY1 

lyut iiic oj'&i/ciii 


o 


1 ^884 






hp?b 


paging & swapping area 


1600 


33440 


100-309 




hp?c 


access entire pack 


0 


131680 


0-822 




ll\J • V4. 




4Qfi00 


1 5884 


30Q-408 




hp?e 




65440 


55936 


409-758 




hr>9f 

lip • 1 




191440 


10080 


7 t iQ-899 




n P • & 


/11QV flip CVCtPTYl 

/ Lift I OJr'Ol/Clll 


4Qfi00 


89080 


30Q-899 


RM05 


hp?a 


root filp WAPITI 

i W V lilt' OJ O l/t-XAA 


o 


15884 


0-26 




hp?b 


paging & swapping area 


16416 


33440 


27-81 




hp?c 


access entire pack 


0 


500384 


0-822 




hp?d 




341696 


15884 


562-588 




hp?e 




358112 


55936 


589-680 




hp?f 




414048 


86176 


681-822 
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RM80 



RP05 



RP06 



RP07 



1 o 

hp?g 


/usr file system 


341696 


158528 


562-822 


1 0 1 

hp?h 




49856 


291346 


82-561 


1 O 

hp?a 


root file system 


0 


15884 


0-36 


hp?b 


paging & swapping area 


16058 


33440 


37-114 


hp?c 


access entire pack 


0 


242606 


0-558 


hp?d 




49910 


15884 


115-151 


hp re 




6809b 


55936 


1 CO OOA 

152-280 


hp?f 




125888 


120466 


281-558 


hp?g 


/ //-» i . 

/usr/file system 


49910 


192510 


115-558 


hp?a 


root file system 


0 


15884 


0-37 


hp?b 


paging & swapping area 


15884 


33440 


38-117 


hp?c 


access entire pack 


0 


171798 


0-410 


hp?d 




2242 


■t POO i 

15884 


118-155 


hp re 




b5208 


55936 




hp?f 




121220 


50424 


c\r\f\ a -i r\ 

290-410 


hp?g 




2242 


122320 


118-410 


hp? a 


root file system 


0 


15884 


0-37 


hp?b 


paging & swapping area 


15884 


33440 


38-117 


hp?c 


access entire pack 


0 


340670 


0-814 


hp?d 




49324 


"1 COO A 

15884 


~i ~i o -t t c 

118-155 


hp re 




65208 


55936 


1 EC OOA 

156-289 


hp?f 




121220 


219296 


290-814 


hp?g 


/usr file system 


49324 


291192 


118-814 


hp?a 


root file system 


0 


15884 


0-9 


hp?b 


paging & swapping area 


16000 


66880 


10-51 


hprc 


access entire pack 


0 


1 AAQAAA 
1008000 


a con 
0-629 


hp?d 




376000 


15884 


235-244 


hp?e 




392000 


307200 


245-436 


hp?f 




699200 


308600 


437-629 


hp?g 




376000 


631800 


235-629 


hp?h 


/usr file system 


83200 


291346 


52-234 



The first partition (partition a) on all drives is normally reserved for the root file sys- 
tem, a backup of the root file system, or a small file system such as /tmp. The second 
partition (partition b) is used for paging and swapping. The third partition is 
reserved for accessing the entire pack; this allows pack-to-pack copying and other 
actions which require access to the entire physical disk. The remaining partitions' 
uses vary according to the disk type and the way you setup your system. 
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The disk partition sizes for a drive are based on a set of four default partition tables. 
For further information, see diskpart(8). The particular table used is dependent on 
the size of the drive. The a partition is the same size across all drives, 15884 sectors. 
The b partition is sized according to the total space on the disk. For drives less than 
about 400 megabytes, the partition is 33440 sectors, while for larger drives the parti- 
tion size is doubled to 66880 sectors. The c partition is always used to access the 
entire physical disk, including the space at the back of the disk reserved for the bad 
sector forwarding table. 

If the disk is larger than about 250 megabytes, an h partition is created with size 
291346 sectors, and regardless of whether the h partition is created, the remainder of 
the drive is allocated to the g partition. 

If you want to split up the g partition into a number of smaller file systems, you may 
use the d, e, and f partitions, all of which overlap partition g. The default sizes for 
these partitions are 15884 for partition d, 55936 for partition e, and the remainder of 
the disk for partition f. 

Drives on UDA50 and IDC controllers do not completely follow these rules. For 
example, the swap partition on an RA81 is only 33440 sectors, and there are not any 
d, e, or f partitions available on an RA60 or RA80. See uda(4) for more information. 

5.1.2. Space Available 

The space available on a disk varies per device. Table 5.2 lists the amount of space 
available on the common disk partitions. For example, on an RA60 drive there are 
two partitions with available space; partition g has 41 megabytes available, and parti- 
tion h has 139 megabytes available. In the table, ? refers to the unit number. 
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Table 5.2 Space Available on Common Disk Partitions 



Drive 


Partition 


Size 


Partition 


Size 


RA60 


ra?g 


41 Mb 


ra?h 


139 Mb 


RA80 


ra?g 


41 Mb 


ra?h 


56 Mb 


RA81 


ra?g 


41 Mb 


ra?h 


380 Mb 


R80 


rb?g 


41 Mb 


rb?h 


550 Mb 


RB80 


rb?g 


41 Mb 


rb?h 


56 Mb 


RK07 


hk?g 


13 Mb 






RL02 


rl?g 


10 Mb 






RL02 (IDC) 


rb?g 


10 Mb 






RM03 


hp?g 


41 Mb 






RM05 


hp?g 


80 Mb 


hp?h 


145 Mb 


RM80 


hp?g 


96 Mb 






RP05 


hp?g 


160 Mb 






RP06 


hp?g 


145 Mb 






RP07 


hp?g 


315 Mb 


hp?h 


145 Mb 



Each disk also has a paging area, typically of 16 megabytes, and a root file system of 8 
megabytes. The distributed system binaries occupy about 22 megabytes, and the 
major sources occupy another 25 megabytes. The binaries and sources overflow dual 
RK07 and dual RL02 systems, but fit easily on most other hardware configurations. 

Disk sizes are measured in disk sectors (512 bytes), but the ULTRIX-32 file system 
blocks vary in size. All user programs report disk space in kilobytes and, where 
needed, specify disk sizes in terms of sectors. The /etc/disktab file used in making 
file systems specifies disk partition sizes in sectors. To override the default sector size 
of 512 bytes, use the se attribute. 

5.1.3. Layout Considerations 

You should consider these points when deciding how to arrange your disks: 

• provide adequate space for your requirements 

• maximize throughput 

• consider the paging area carefully 

As distributed, the system sizes the configured paging areas each time the system is 
booted. You can define multiple paging areas of different sizes so they will be inter- 
leaved. Drives smaller than 400 megabytes have 16 megabyte swap partitions; drives 
larger than 400 megabytes have 32 megabyte swap partitions. 

Many common system programs (C, the editor, the assembler and so forth) create 
intermediate files in the /tmp directory. Therefore, you must make the file system 
where /tmp will be stored large enough to accommodate these common programs. If 
you have several disks, it is wise to mount /tmp in a root file system (partition a) on 
another disk. All programs that create files in /tmp usually delete them. However, 
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you should periodically examine /tmp and delete any old files that /tmp may have 
missed. 

The disk controller configuration affects the efficiency with which the ULTRIX-32 
system is able to use the CPU. For general time-sharing applications, try to split the 
root file system (/), system binaries (/usr), the temporary files (/tmp), and the user 
files among several disk arms, and interleave the paging activity among several disk 
arms. 

For good performance, you must balance the disk load. There are at least five com- 
ponents of the disk load that you can divide among the available disks: 

• root file system 

• /tmp file system 

• /usr file system 

• user files 

• paging activity 

Table 5.3 shows some disk load possibilities for systems with two, three, and four 
disks. The numerical values in the table are the partitions. Where there is an x , you 
chose the partition. For example, on a system with two or three disks, you can load 
the archive files on any partition you chose. But on a system with four disks, you 
should load the archive files in the fourth partition. 

Table 5.3 Disk Load Possibilities 



file 


two 


three 


four 


system 


disks 


disks 


disks 


/ 


1 


2 


2 


tmp 


1 


3 


4 


usr 


1 


1 


1 


paging 


1+2 


1+3 


1+3+4 


users 


2 


2+3 


2+3 


archive 


X 


X 


4 



The most important balance consideration is to even out the disk load as much as pos- 
sible. You can even the load by decoupling file systems between which heavy copying 
occurs. It is much more important to have an instantaneously balanced load when the 
system is busy, than to have a long term average balanced load. 

By experimenting with a few file system arrangements, you can greatly improve the 
system's performance. It is particularly easy to move the root, the /tmp file system 
and the paging areas. Place the user files and the /usr directory as space needs dic- 
tate and experiment with the other, more easily moved file systems. 
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5.1.4. File System Parameters 

Each file system has parameters according to its block size, fragment size, and the disk 
geometry characteristics of the medium on which it resides. If you specify the wrong 
disk characteristics or choose inadequate file system parameters, the throughput (i/o 
seek time) may be substantially degraded or a significant amount of disk space may be 
wasted. As distributed, the file systems are configured as shown in Table 5.4. 



The root file system block size is large (eight Kbytes) so it will optimize the 
bandwidth to the associated disk. This is very important because the /tmp directory 
is normally part of the root file. The large block size is also important because many 
of the most heavily used programs are demand paged out of the /bin directory. 

The /usr file system uses a four Kbyte block size with 512 byte fragment size in an 
effort to get high performance while conserving the amount of space wasted by a large 
fragment size. 

The file systems for users have a four Kbyte block size with one Kbyte fragment size. 
The four Kbyte block size provides adequate bandwidth while the one Kbyte fragment 
size provides acceptable space compaction and disk fragmentation. 

You may chose other parameters in constructing file systems, but keep in mind that 
there are many factors involved which interact in complex ways in choosing a block 
size and fragment size. 

Larger block sizes result in better throughput to large files in the file system because 
larger i/o requests will then be performed by the system. However, you must also con- 
sider the average file sizes in the file system and the performance of the internal sys- 
tem buffer cache. 

The system provides space in the inode for 12 direct block pointers, 1 single indirect 
block pointer, and 1 double indirect block pointer. If a file uses only direct blocks, 
you can optimize access time to it by maximizing the block size. If a file spills over 
into an indirect block, increasing the block size of the file system may decrease the 
amount of space used by eliminating the need to allocate an indirect block. However, 
if the block size is increased and an indirect block is still required, then more disk 
space will be used by the file because indirect blocks are allocated according to the 
block size of the file system. 

You should consider two main points when you are selecting a fragment size for a file 
system. The first consideration is the major performance tradeoffs between an eight 



Table 5.4 ULTRIX-32 File System Configurations 



Fil e S y s tem Block Size 

/ 8 Kbytes 

user 4 Kbytes 

users 4 Kbytes 



Fragment Size 



1 Kbytes 
512 bytes 
1 kbytes 
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Kbyte block file system and a four Kbyte block file system. The block size to frag- 
ment size ratio can not be greater than eight. This means that an eight Kbyte file sys- 
tem will always have a fragment size of at least one Kbytes. If a file system is created 
with a four Kbyte block size and a one Kbyte fragment size, then upgraded to an eight 
Kbyte block size and one Kbyte fragment size, identical space compaction occurs. 

However, if a file system has a 4 Kbyte block size and 512 byte fragment size, convert- 
ing it to an 8K/1K file system results in significantly more space being used. This 
implies that four Kbyte block file systems which might be upgraded to eight Kbyte 
blocks for higher performance should use fragment sizes of at least one Kbytes to 
minimize the amount of work required in conversion. \ 

The second consideration when selecting the fragment size for a file system is the level 
of fragmentation on the disk. With a 512 byte fragment size, storage fragmentation 
occurs much sooner, particularly with a busy file system running War full capacity. 
By comparison, the level of fragmentation in a one Kbyte fragment file system is an 
order of magnitude less severe. On file systems where many files are created and 
deleted, the 512 byte fragment size is more likely to result in apparent space exhaus- 
tion due to fragmentation. That is, when the file system is nearly full, file expansion 
which requires locating a contiguous area of disk space is more likely to fail on a 512 
byte file system than on a 1 Kbyte file system. 

To minimize fragmentation problems of this sort, a parameter in the super block 
specifies a minimum acceptable free space threshold. If users (anyone but the 
superuser) attempt to allocate disk space and the free space threshold is exceeded, the 
user is returned an error as if the file system were actually full. By default, this 
parameter is set to 10%; you may change it by supplying a parameter to newfs(8), or 
by patching the super block of an existing file system using tunefs(8). 

In general, unless a file system is to be used for a special purpose application (for 
example, storing image processing data), you should use the default values supplied. 
Remember that the current implementation limits the block size to at most eight 
Kbytes and the ratio of block size to fragment size must be in the range 1—8. 

The disk geometry information which the file system uses affects the block layout 
methods used. The file /etc/disktab contains the data for most of the drives sup- 
ported by the system (although not all of these drives are supported by Digital Equip- 
ment Corporation). When constructing a file system, use the newfs(8) program and 
specify the type of disk on which the file system resides, /etc/disktab also contains 
the default file system partition sizes, and default block and fragment sizes. You can 
override any of the default values by modifying /etc/disktab, or by using one of the 
newfs options. 
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5.1.5. Implement the Layout 

To implement your disk layout, use the newfs(8) command to create each new file 
system. You must also add each file system to the / etc /f stab file so that it will be 
checked and mounted when the system is bootstrapped. 

For example, consider a system with RM03s. On the first RM03 (hpO) you would put 
the root file system in partition hpOa, and the /usr file system in hpOg, which has 
more than enough space to hold it. The /tmp directory would be part of the root file 
system, because no file system will be mounted on it. 

If there were only one RM03 in this example, then you would put user files in the 
hpOg partition along with the binaries. 

If you had a second RM03 (hpl), you would create a file system in hplg and put user 
files there, calling the file system /mnt. You would also need to interleave the paging 
between the two RM03 drives. To do this you would build a system configuration 
that specified the following: 

config vmunix root on hpO swap on hpO and hp1 

You would then add the following lines to the / etc /f stab file: 

/dev/hp1b::sw:: 
/dev/hp1g:/mnt:rw:1:2 

You should keep a backup copy of the root file system in the hp la disk partition. 
To make the /mnt file system you would type: 

# cd /dev 

# MAKEDEV hp1 

# newfs hplg rm03 



information about the file system prints out 



# mkdir /mnt 

# mount /dev/hp1g /mnt 



5.2. Set up the Line Printer System 

If you have a line printer configured in to your system (that is, if there is an entry 
describing a line printer in the system's configuration file, and a device type in the 
/dev directory), the line printer facility will work as distributed. 



120 ULTRIX-32 Installation Guide 



The basic line printer system consists of these files and commands: 

/usr/ucb/lpq spooling queue examination program 
/usr/ucb/lprm delete jobs from a queue program 
/usr/ucb/lpr enter a job in a printer queue program 
/etc/printcap printer configuration and capability data base 
/usr/lib/lpd line printer daemon, scans spooling queues 
/etc/lpc line printer control program 

The file /etc/printcap is a master data base describing line printers directly attached 
to a machine, and printers accessible across a network. printcap(5) describes the for- 
mat of this data base and also indicates the default values for such things as the direc- 
tory in which spooling is performed. 

The line printer system handles multiple printers, multiple spooling queues, local and 
remote printers, and also printers attached via serial lines which require line initializa- 
tion such as the baud rate. 

Remote spooling via the network is handled with two spooling queues: one on the local 
machine, and one on the remote machine. When a remote printer job is initiated with 
Ipr ( , ) the job is queued locally and a daemon process is created to oversee the transfer 
of the job to the remote machine. If the destination machine is unreachable, the job 
will remain queued until it is possible to transfer the files to the spooling queue on the 
remote machine. The Ipq ( ) program shows the contents of spool queues on both the 
local and remote machines. 

To configure your line printers, consult printcap(5) and 4.2BSD Line Printer Spooler 
Manual. A call to the Ipd (8) program should be present in /etc/rc. 

5.3. Set up the Mail System 

The mail facility distributed with the ULTRIX-32 system will work properly as distri- 
buted. 

The mail system consists of these commands: 

/ b i n / m a i I old standard mail program 

(from 32/V) 

/usr/ucb/mail UCB mail program, described in 

mail{\) 

I usr / lib / sendmail mail routing program 

/usr/ spool /mail mail spooling directory 

/usr/ spool /secretmail secure mail directory 

/usr/bin/xsend secure mail sender 

/usr/bin/xget secure mail receiver 

/usr /lib /aliases mail forwarding information 

/usr/ucb/newaliases command to rebuild binary 

forwarding database 
/ usr/ ucb/ biff mail notification enabler 
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/etc/ comsat 
/etc/syslog 



mail notification daemon 
error message logger, used by 
sendmail 



Mail is usually sent and received via the mail(l) command, which provides a front- 
end to edit the messages sent and received, and passes the messages to sendmail (8) 
for routing. 

The routing algorithm uses knowledge of the network name syntax, aliasing and for- 
warding information, and network topology, as defined in the configuration file 
/usr/ lib/ sendmail. cf, to process each piece of mail. 

Local mail is delivered through the /usr/ bin /mail program, which adds the mail to the 
appropriate /usr /spool/ mail lusername mailbox, /usr/ bin /mail uses a locking protocol 
to avoid problems with simultaneous updates. After the mail is delivered, the local 
mail delivery daemon /etc /comsat is notified, which in turn notifies users who have 
issued the biff ( 1 ) command that mail has arrived. 

Mail queued in the directory /usr/spool/mail is readable only by the recipient. To 
send encrypted mail that only the recipient can read use the secret mail facility 
xsend (1). 

To set up the mail facility, read the instructions in the file READ ME in the directory 
/usr/src/usr.lib/sendmail and then edit the necessary configuration files. Also, set up 
the file /usr/ lib /aliases for your installation, and create mail groups as appropriate. 
Consult the document Sendmail Installation and Operation Guide (also included in 
this binder) and sendmail (8) for further information. 

5.4. Set up a UUCP Connection 

These are the basic steps for installing a uucp (UNIX to UNIX Copy) connection: 

• Choose the hardware and install it. 

• Set up the special files corresponding to that hardware. 

• Install the uucp software and related files. 

Read the document UUCP Installation and Administration for detailed instructions 
on how to set up a uucp connection. 

5.5. Additional Software 

This subsection describes how to extract the additional software from the second dis- 
tribution tape and the third RK07 distribution disk pack. 

If your distribution is on an RA60 pack or on RL02 packs then your system already 
has the additional software installed. If you find your system requires more disk 
space, you can decide which additional software files your users do not need and 
remove them without disturbing your system's performance. 
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The additional software is made up of six optional packages. Table 5.5 gives the name 
of each package in the order it appears on the distribution media (tape or RK07 disk), 
the approximate disk usage of each package in blocks, and a brief description of each 
package. 



Table 5.5 The Additional Software Packages 


File 


Disk Usage 


Description 


/usr/man 


2400 


on-line manuals, sections 1-8 of 






the ULTRIX-32 Programmer's Manual 


/usr/games 


2200 


game programs 


/usr/doc 


4500 


sources to UNIX documentation 






(minus sections 1-8) 


/usr/lib/vfont 


2600 


font libraries for Varian or 






Versatec printer/plotters 


/usr/lib/learn 


900 


learn scripts for learning how to 






use the ULTRIX-32 operating system 


/usr/lib/lisp 


X200 


lisp documentation 



Table 5.5 can help you decide whether you have room for some, all, or none of the 
additional software. 

Note that the doc and vfont disk usage is given in the compacted form. If you want to 
use either of these files you should read the README file in the /usr/doc or 
/usr/lib/vfont directory. 

None of the Additional Software files are necessary for normal operation of your 
ULTRIX-32 system, but they are useful because they contain on-line learning tools. 

The next two subsections explain how to extract the Additional Software from the dis- 
tribution tape and Rk07 pack. 

NOTE: Everytime you execute the newfs(8) command, save the numbers generated. 
A good place to keep them is taped to the outside of the disk cover (if the pack is 
removable). 

5.5.1. Extracting Additional Software from the Second Tape 

If you have room on the /usr partition of your system disk, you can extract all or 
some of the files from the second tape and place them in /usr. Otherwise, you can 
place the files in a partition of another disk, and make symbolic links. See df ( 1 ) for 
more information about disk space usage. 
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5.5.1.1. If /usr of System Disk is Available 

If you have enough room in the /usr partition of your system disk and want to extract 
all of the tape files, enter the following commands in the order given. 

NOTE: If you are putting the file(s) on a partition that has not previously been used, 
you must do a newfs(8) first, and then edit the file / etc /f stab, adding an entry for 
the partition. (See subsection 3.1 of this document or Guidelines for System Manage- 
ment for information on how to edit / etc /f stab.) For example, if you were placing the 
file(s) on partition g of an RM03 disk in drive 1, type: 

# newfs rhplg rm03 

and add the following line to / etc /f stab: 

/dev/hp1g:/usr:rw:1:2 

CAUTION: newfs destroys the data on the partition specified; therefore, use caution 
when using newfs. 

If you want to skip some of the files, you must position the tape at the desired tape 
file before entering the commands to extract the file. To do this, do not issue the tar 
command in the sequence below, for each tape file you want to skip. 

Each tar command (file extraction) will take about five minutes to complete. 



# 


cd 


/usr 


(make /usr the current directory) 


# 


tar 


xpf /dev/rmt12 


(extract on-line manuals) 


# 


mt 


fsf 




# 


tar 


xpf /dev/rmt12 


(extract user games) 


# 


mt 


fsf 




# 


tar 


xpf /dev/rmt12 


(extract UNIX documentation) 


# 


mt 


fsf 




# 


cd 


/ usr / lib 


(make /usr/ lib the current directory) 


# 


tar 


xpf /dev/rmt12 


(extract vfont libraries) 


# 


mt 


fsf 




# 


tar 


xpf /dev/rmt12 


(extract learn scripts) 


# 


mt 


fsf 




# 


tar 


xpf /dev/rmt12 


(extract lisp manual) 
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When you have finished extracting files from the tape, enter: 

# mt offl ; sync 

Then unload the tape from the tape drive, and store it in a safe place. 
You have now completed the ULTRIX-32 operating system installation. 
5.5.1.2. If /usr of System Disk is Not Available 

If you do not have room in /usr of the system disk for the files on the second tape, 
then you need to make a site-specific decision about which files your users will need, 
and where those files will be placed. (See df ( 1 ) for more information about disk space 
usage.) 

You can place the tape files in a partition of another disk, and then make a symbolic 
link from the directory where they would normally reside to where they actually 
reside. 

Here is an example of how to extract the games tape file onto a system consisting of 
two RK07 drives. Assume there is no room in the g partition of the system disk 
(ROOT), but there is room in the g partition of the second RK07 (USERS). Mount 
the g partition onto the /usr/ users directory. Then extract the games file in 
/usr /users /games. Last, make a symbolic link from /usr to /usr /users. Name the 
link games. 

# /etc/mount /dev/hk1g /usr/users 

# cd /usr/users 

# mt fsf 

# tar xpf /dev/rmtl2 

# mt fsf 

# In -s /usr/games /usr /user s/games 

Note that in this situation you will be giving up user space by placing the additional 
software information in /usr/users. Therefore it is important that you only extract 
the additional software files that your users really need. 

To skip some of the files you must position the tape at the desired tape file before 
entering the commands to extract the file. 

Repeat the tar, chmod, mt, and In commands, substituting the appropriate file name 
for each file you wish to extract from the tape. 

Be sure you are in the correct current directory. In our example to extract 
/usr/games, /usr/users should be the current directory. 



(to skip man - see below) 
(extract the games) 
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When you have finished extracting files from the tape, enter: 

# mt offl ; sync 

Then unload the tape from the tape drive, and store it in a safe place. 

Check the / etc /f stab file to be sure there is an an entry for the partition. The entry 
ensures that the file system will be checked automatically and mounted on reboot. 

Use the cat ( 1 ) command to see if the entry exists; if it does not, then edit the file and 
add it. 

For example, in our case with the RK07 disks, first use cat: 

/dev/hk0a:/:rw:1:1 
/dev/hk0g:/usr:rw:1:3 
/ dev / hk 1 a: / mnt:rw: 1 :2 

In this example there is no entry for /dev/hk1g, therefore you should edit the 
/ etc /f stab file, adding a line like this: 

/dev/hk1g:/dev:rw: 1:3 

You have now completed the ULTRIX-32 operating system installation. 

5.5.2. Extracting Additional Software from the Third RK07 

The system must be in single-user mode; type: 

# /etc/shutdown -h 

Spin down the ROOT pack in drive 0 and load the pack labeled ADDITIONAL 
SOFTWARE. When the ADDITIONAL SOFTWARE pack (in drive 0) is spinning 
and the READY light is lit, reboot the system to single-user mode (subsection 2.5.1). 

After the system is rebooted type: 

# /etc/mount /dev/hk1g /usr 

The /dev/hk1g partition is normally mounted on /usr/ users. In this particular 
instance, however, we are mounting it on /usr for convenience. 

Repeat the following two commands, substituting the name of the file you want to 
extract for file, until you have extracted all the files your users will need (and that will 
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fit on your particular system): 

# cd /usr 

# tar xpf /dev/rhkOg file 

After you have extracted all the files needed, type: 

# sync 

# halt 

Spin down and unload the ADDITIONAL SOFTWARE pack in drive 0 and load the 
ROOT pack. When drive 0 is spinning and the READY light is lit, reboot the system 
to single-user mode (subsection 2.5.2). 

After the system has been rebooted to single-user mode, check the filesystem and then 
mount all the devices: 

# fsck 

# /etc/mount /dev/hk1g 

Then set up a symbolic link for each additional software file extracted. For example, 
to set up a symbolic link for games: 

# In -s /usr/users/games /usr/games 

After all the symbolic links have been made bring the system up to multi-user mode: 

# <CTRL/D> 

You have now completed the ULTRIX-32 operating system installation. 



APPENDIX A - Bootstrap Details 
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This appendix contains pertinent files and numbers for the ULTRIX-32 bootstrap 
procedure. If you have problems installing the distribution on your machine, you may 
find this material useful. 



1. Contents of the Distribution Tapes 

The tape distribution consists of two 1600bpi 2400' magnetic tapes. All tape files are 
blocked in 10 kilobytes records, except for the first file on the first tape which has 512 
byte records. 

The first distribution tape contains the following files. Note that the number of 
records given are approximate. 



Tape File Records Contents 



one 194 eight tape bootstraps and a 

tp(l) image containing the 
stand-alone-images of boot, 
format, and copy 
two 300 "mini-root" file system image 

three 380 dump (8) image of distribution 

root file system 
four 440 tar (1) image of kernel objects 

five 2111 tar image of usr filesystem 

binaries and libraries in /usr 



The second distribution tape contains the following files. Note that the number of 
records and blocks given are approximate. 

Tape File Records Blocks Contents 



one 


243 


2257 


tar image of /usr/man 


two 


214 


3409 


tar image of /usr/games 


three 


523 


5198 


tar image of /usr/doc 


four 


576 


5677 


tar image of /usr/lib/vfont 


five 


92 


795 


tar image of /usr/lib/learn 


six 


48 


483 


tar image of /usr/lib/lisp 



The distribution tapes were made with the shell scripts located in the directory 
/sys/dist. 
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2. Control Status Register Addresses 

The distribution uses many stand-alone device drivers that presume the location of a 
UNIBUS device's control status register (CSR). Table A-l summarizes these values. 

Table A-l 

Device Name Controller CSR Address (octal) 



ra UDA50 0172150 

rb 730 IDC 0175606 

rk RK11 0177440 

rl RL11 0174400 

ts TS11 0172520 



All MASSBUS controllers are located at standard offsets from the base address of the 
MASSBUS adapter register bank. 

3. Generic System Control Status Register Addresses 

The generic version of the operating system supplied with the distribution contains 
the UNIBUS devices indicated below. The system recognizes these devices if the 
appropriate control status registers respond at any of the indicated UNIBUS 
addresses. 



Device Name 


Controller 


CSR Addresses (octal) 


hk 


RK11 


0177440 


ra 


UDA-50 


0172150, 0172550, 0177550 


rb 


730 IDC 


0175606 


rl 


RL11 


0174400 


dn 


DN11 


0160020 


dz 


DZ11 


0160100, 0160110, ... 0160170 


ts 


TS11 


0172520 


dmf 


DMF32 


0160340 


lp 


LP11 


0177514 



If devices other than the above are located at any of the addresses indicated, the sys- 
tem may not bootstrap properly. 
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APPENDIX B - Installation Troubleshooting 



This appendix lists and explains problems you might encounter while installing the 
ULTRIX-32 software distribution. This information is limited to the early steps in 
the installation process; that is, up to the point where the root file system is installed. 
If you have a problem installing the release consult this section for an indication of 
the problem before contacting your Digital representative. 

1. Using the Distribution Console Medium 

This section describes problems which may occur when using the programs provided 
on the distributed console medium: TU58 cassette or RX01 diskette. 

boot prints "bad format" 

The program you requested boot to load did not have a 407, 410, or 413 magic number 
in its header. This should never happen on a distribution system. If you were trying 
to boot off the root file system, reboot the system on the miniroot file system and look 
at the program on the root file system. Try copying the copy of vmunix on the 
miniroot to the root file system also. 

boot prints "not a directory" 

The boot program was unable to find the requested program because it encountered 
something other than a directory while searching the file system. This usually indi- 
cates no file system is present on the disk partition supplied, or the file system has 
been corrupted. First check to make sure you typed the correct line to boot. If this is 
the case and you are booting off the miniroot file system, the miniroot was probably 
not copied correctly off the tape (perhaps it was not placed in the correct disk parti- 
tion). Try reinstalling the miniroot file system or, if trying to boot the true root file 
system, try booting off the miniroot file system and run fsck on the restored root file 
system to insure its integrity. Finally, as a last resort, copy the boot program from the 
miniroot file system to the newly installed root file system. 

boot prints "read short" 

The file header for the program indicated a size larger than the actual size of the file 
located on disk. This is probably the result of file system corruption (or a disk i/o 
error). Try booting again or creating a new copy of the program to be loaded (see 
above). 

copy does not copy 300 records 

If a tape read error occurred, clean your tape drive heads. If a disk write error 
occurred, the disk formatting may have failed. If the disk pack is removable, try 
another one. If you are currently running UNIX, you can reboot your old system and 
use dd to copy the miniroot file system into a disk partition (assuming the destination 
is not in use by the running system). 
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format, boot, or copy prints "unknown device". 

The device specified is probably not one of those supported by the distribution; con- 
sult subsection 1.1. If the device is listed in subsection 1.1, the drive may be dual- 
ported, or for some other reason the driver was unable to decipher its characteristics. 
If this is a MASSBUS drive, try powering the MASSBUS adapter and/or controller on 
and off to clear the drive type register. 

program can not be loaded. 

Check to make sure the correct floppy or cassette is being used. If using a floppy, be 
sure it is not in upside down. If using a cassette on an 11/730, be certain drive 0 is 
being used. If a hard i/o error occurred while reading a floppy, try reseting the con- 
sole LSI-11 by powering it on and off. If you can not boot the cassette's bootstrap 
monitor, verify the standard DEC console cassette can be read; if it can not, your 
cassette is broken — not uncommon. 

program halts without warning. 

Check to make sure you have specified the correct disk to format. On 11/750's, speci- 
fying a non-existent MASSBUS device will cause the program to halt as it receives an 
interrupt (standalone programs operate by polling devices). 

If using a floppy, try reading the floppy under your current system. If this works, 
copy the floppy to a new one and begin again. If using a cassette on an 11/730, do 
likewise. 

A MASSBUS disk was specified, but the associated MASSBUS drive type register 
indicates a drive of unknown type. This probably means you typed something wrong 
or your hardware is incorrectly configured. 

WARNING: clock gained xx days - CHECK AND RESET THE DATE! 
WARNING: preposterous time in file system - CHECK AND RESET THE DATE! 

If you receive either one of these warnings, ignore it; you will set the date later when 
you boot the full root. 

2. Booting the Generic System 

This section contains common problems encountered when booting the generic version 
of the system. 

system crashes during autoconfiguration 

This is almost always caused by an unsupported UNIBUS device being present at a 
location where a supported device was expected. You must disable the device in some 
way, either by pulling it off the bus, or by moving the location of the console status 
register (consult Appendix A for a complete list of UNIBUS csr's used in the generic 
system). 

system does not find device (s) 

Either the device was at a non-standard address, or the device is not configured into 
the generic system. See Appendix A for a list of devices and their control status 
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register addresses. 

Alternatively, certain devices are difficult to locate during autoconfiguration. A classic 
example is the TS11 tape drive which does not autoconfigure properly if it is rewind- 
ing when the system is rebooted. Tape drives should configure properly if they are off 
line, or are not performing a tape movement. Disks which are dual-ported should 
autoconfigure properly if the drive is not being simultaneously accessed through the 
alternate port. 

system panics with "panic: Unit" 

This occurred because the system was unable to locate the program /etc /in it. The root 
file system supplied at the root device? prompt was probably incorrect. Remember 
that when running on the miniroot file system, this question must be answered with 
something of the form hpO* If the answer had been hpO, the system would have used 
the a partition on unit 0 of the hp drive, where presumably no file system exists. 

Alternatively, the file system on which you were trying to run is corrupted, or simply 
missing /etc/init. Try reinstalling the appropriate file system or installing a version of 
init. 

system selects incorrect root device 

That is, you try to boot the system single user with B/2 or B xxS but do not get the 
root filesystem in the expected location. This is most likely caused by your having 
many disks available more suited to be a root file system than the one you wanted. 
For example, if you have a up disk and an hk disk and install the system on the hk, 
then try and boot the system to single-user mode, the heuristic used by the generic 
system to select the root file system will choose the up disk. The following list gives, 
in descending order, those disks thought most suitable to be a root file system: hp, up, 
ra, rb, rl, hk (the position of rl is subject to argument). To get the root device you want 
you must boot using B / 3 or B ANY, then supply the root device at the prompt. 

3. Building Console Cassettes 

This sections describes common problems encountered while constructing a console 
bootstrap cassette. 

system crashes 

You are trying to build a cassette for an 11/750. On an 11/750 the system is booted 
by using a bootstrap prom and sector 0 of the root file system. Consult tu ( (4) ) for the 
appropriate reprimand. 
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APPENDIX C - Loading the Tape Monitor 



This appendix indicates how to load the bootstrap monitor located on the first tape of 
the distribution tape. Loading the monitor should not be necessary, but instructions 
have been included as a fallback measure (in case it is not possible to read the distri- 
buted console medium.) 

NOTE: In certain cases on an 11/730 system, the bootstraps supplied below may not 
work. Consult your Digital representative if you are unable to load the monitor on an 
11/730 system. 

To load the tape bootstrap monitor, first mount the magnetic tape on drive 0 at load 
point, making sure that the write ring is not inserted. Set the reboot switch to OFF 
on an 11/780 or 11/730. On an 11/750 set the power-on action switch to halt. (Gen- 
erally an 11/780 or 11/730 system will have the reboot switch on, and an 11/750 sys- 
tem will have the power-on action set to boot/restart.) 

If you have an 11/780 system enter: 

»> HALT 
»> UNJAM 

Then, on any machine, enter the init(8) command: 

»>I 

Then, key in at location 200 and execute either the TS, HT, TM, or MT bootstrap 
described in Table B.l, as appropriate. The machine's printouts are shown in regular 
print, explanatory comments are within ( ). (You can use <DELETE> to delete a 
character and <CTRL/U> to remove an entire line.) 

Table B.l Bootstrap Procedures 



TS bootstrap 

»> D/P 200 3AEFD0 
»> D + D05A0000 
»> D + 3BEF 
»> D + 800CA00 
»> D + 32EFC1 
»> D + CA010000 
»> D + EFC10804 
»> D + 24 
»> D + 15508F 
»> D + ABB45B00 
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>»D + 2AB9502 

»>D + 8FB0FB18 

»>D + 956B024C 

»>D + FB1802AB 

»>D + 25C8FB0 

>»D + 6B 

(The next two deposits set up the addresses of the 
UNIBUS adapter and its memory; the 20006000 here 
is the address of the 11/780 ubaO and the 2013E000 
the address of the 11/780 umemO) 

»>D + 20006000 (780 ubaO) 

(780 ubal: 20008000, 750 uba: F30000, 730 uba: F26000) 

>»D + 2013E000 (780 umemO) 

(780 umeml: 2017E000, 750 umem: FFE000, 730 umem: FFE000) 

»>D + 80000000 

»>D + 254C004 

»>D + 80000 

>»D + 264 

»>D + E 

»>D + C001 

»>D + 2000000 

»>S 200 

HT bootstrap 

»>D/P 200 3EEFD0 
»>D + C55A0000 
»>D + 3BEF 
»>D + 808F00 
»>D + C15B0000 
»>D + C05B5A5B 
»>D + 4008F 
»>D -I- D05B00 
»>D + 9D004AA 
»>D + C08F326B 
»>D + D424AB14 
»>D + 8FD00CAA 
»>D + 80000000 
»>D 4- 320800CA 
»>D + AAFE008F 
»>D + 6B39D010 
»>D 4- 0 

(The next two deposits set up the addresses of the 
MASSBUS adapter and the drive number for the tape 
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formatter. The 20012000 here is the address of 

the 11/780 mbal and the 0 reflects that the 

formatter is drive 0 on mbal) 
»> D + 20012000 (780 mbal) (780 mbaO: 20010000, 750 mbaO: F28000) 
»> D + 0 (Formatter unit number in range 0-7) 
»> S 200 
»> S 200 



TM bootstrap 



»> 


D/P 


200 2AEFD0 


»> 


D 


+ 


D0510000 


»> 


D 


+ 


2000008F 


»> 


D 


+ 


800C180 


»> 


D 


+ 


804C1D4 


»> 


D 


+ 


1AEFD0 


»> 


D 


+ 


C8520000 


»> 


D 


+ 


F5508F 


»> 


D 


+ 


8FAE5200 


»> 


D 


+ 


4A20200 


»> 


D 


+ 


B006A2B4 


»> 


D 


+ 


2A203 



(The following two numbers are ubaO and umemO; see 
TS above for some hints on other values if your 
TM is not on UBAO on a 780) 

»> D + 20006000 (780 ubaO) 

»> D + 2013E000 (780 umemO) 

»> S 200 

»> S 200 

»> S 200 



MT bootstrap 

»> D/P 200 46EFD0 
»> D + C55A0000 
»> D + 43EF 
»> D + 808F00 
>» D + C15B0000 
»> D + C05B5A5B 
»> D + 4008F 
>» D + 19A5B00 
»> D + 49A04AA 
»> D + AAD408AB 
»> D + 8FD00C 
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»>D + CA800000 

»>D + 8F320800 

»>D + 10AAFE00 

»>D + 2008F3C 

»>D + ABD014AB 

»>D + FE15044 

»>D + 399AF850 

»>D + 6B 

(The next two deposits set up the addresses of the 
MASSBUS adapter and the drive number for the tape 
formatter. The 20012000 here is the address of 
the 11/780 mbal and the 0 reflects that the 
formatter is drive 0 on mbal) 

»>D + 20012000 

»>D + 0 

»>S 200 

»>S 200 

»>S 200 

»>S 200 



(no toggle-in code exists for the UT device) 

If the tape does not move the first time you start the bootstrap program with S 200 
you probably entered the program incorrectly (but also check that the tape is online). 
Start the procedure over again. For the HT, MT, and TM bootstraps you cannot see 
the tape move as you advance through the first few blocks as the tape motion is all 
within the vacuum columns. 

Next, deposit the address of the tape MBA/UBA in RA. In RB, deposit the appropri- 
ate address of the device registers or unit number. 



»>D/G A 20006000 
»>D/G A 20008000 
»>D/G A 20012000 
»>D/G A 20010000 
»>D/G A F30000 
»>D/G A F2A000 
»>D/G A F28000 
»>D/G A F26000 



(for tapes on 780 ubaO) 
(for tapes on 780 ubal) 
(for tapes on 780 mbal) 
(for tapes on 780 mbaO) 
(for tapes on 750 ubaO) 
(for tapes on 750 mbal) 
(for tapes on 750 mbaO) 
(for tapes on 730 ubaO) 



For register B: 
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»>D/GB0 
»>D/GB 1 
»>D/G B 2013F550 
»> D/G B FFF550 



(for tm03/tm78 formatters at mba? drive 0) 
(for tm03/tm78 formatters at mba? drive 1) 
(for tmll/tsll/tu80 tapes on 780 ubaO) 
(for tmll/tsll/tu80 tapes on 750 or 730 ubaO) 



Then start the bootstrap program with 
»>S 0 

The console should display 

You are now talking to the tape bootstrap monitor. At any point during the rest of 
the installation you can return to this section, reload the tape bootstrap, and restart 
the procedure. The console monitor is identical to that loaded from a TU58 console 
cassette. Follow the instructions in section 2 as they apply to this device. The only 
exception is that when using programs loaded from the tape bootstrap monitor, pro- 
grams will always return to the monitor (the = prompt). This saves you typing in the 
toggle-in code for each program to be loaded. 

For the TU58 monitor, the programs restart themselves. You must therefore restart 
the monitor to get the console prompt. 
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